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SECTION 1 
INTRODUCTION 


THE CMS CONCEPT 


CMS (Computer Management System) software is a powerful set of software items designed to operate on 
a number of different hardware products. 


To the user of an individual hardware product running CMS software, there is a well-defined operator inter- 
face and set of programming languages. The importance of CMS is that the same user may use a different hard- 
ware product running CMS software, and with the same languages. This portability eliminates major operator 
retraining between different CMS products. It also allows freedom of interchange of programs between hardware 
products, limited only by availability of hardware features. For example, a program may be developed and com- 
piled on one system, and run on another. Also, because the compilers are also programs, there is portability 
of compilers between hardware systems as well. Data files are similarly transferable from one system to another. 
This portability is achieved by building on the “soft machine” concept. Refer to figure 1-1. 


SOURCE 
PROGRAM 


COMPILER 


OBJECT 
CODE 
PROGRAM 
(S-CODE) 


INTERPRETER INTERPRETER 
A B 


HARDWARE HARDWARE 
A | | B 


SOFT MACHINE A : SOFT MACHINE B 


Figure 1-1. CMS Portability 
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The programmer writes a program in a high-level language. The CMS programming languages are: 
COBOL : : 
RPG (including RPGII) 
MPL (CMS Message Processing Language) 
NDL (Network Definition Language). 


This program is writen in ‘source code’. This is then input to one of the CMS compilers which converts it 
o “object code” or “‘S-code’’. This is the executable program. The ‘“S-code”’ is similar in design to the ‘“‘machine 
code” of earlier generations of computer. 


In earlier generations of computer this ‘‘S-code’”’ would be executed by hard-wired instructions. With the ad- 
vent of fast micro-processor computers, however, it is possible to build a set of micro-instructions which inter- 
prets each “‘S-code”’ and executes it. The set of micro-instructions is therefore called an “interpreter”. The com- 
bination of interpreter and micro-processor hardware is sometimes termed a “‘soft machine’’. 


Now as the ‘‘S-code” is independent of any particular hardware, it is possible (and has been achieved in CMS) 
to build several soft machines which will execute a “object program” in a similar manner. Hence the CMS ob- 
ject programs are portable across the different CMS machines. 


These machines include: 
B 80 
B 800 
B 1800 


There are three different CMS interpreters on each system. On the B 80 these are: 
BILINTERP 
COBOLINT 
NDL.INTERP 


On the B 800 the interpreters are part of the MCP (see later). 


The BILINTERP is used to execute programs written in MPL and in BIL (an implementation language used 
for compiler-writing which is so similar to MPL that they share the same S-code format). The COBOLINT is 
used to execute programs written in COBOL and RPG (these two languages share the same S-code format). 
The NDL.INTERP is used to interpret data communication controller programs written in NDL. 


Certain common features needed in all programs (such as the handling of peripheral devices) have been col- 
lected together into a Master Control Program (MCP). The MCP is a micro-code program and is therefore spe- 
cifically written for each hardware product. Thus there is a B 80 MCP, and B 800 MCP and a B 1800 MCP. 
The MCP also controls the operator interface (which is standard across the CMS range) and maintains overall 
control of the system, providing complete resource management including multi- “programming, I/O device han- 
dling and memory paneeement 


CMS software also provides a number of utility programs. As these are written in MPL, they also are portable 
across the CMS range, limited euly by hardware feature availability. | 


To cover the complete features of each CMS product line, certain aspects of the software are written for a 


specific product. These additional features include important operational characteristics, and are described in 
sections 8, 9 and 10. Sections 2 through 7 of this manual cover items which are t applicable to any CMS product. 


1—2 


SOFTWARE RELEASE LEVELS 


Each item on a CMS software release is identified by a three-part number, as follows: 


X. XX. XX 


—_ patch number 
: level number 


mark number 


The mark and level numbers constitute the release number. For example, the COBOL compiler 3.01.08 is 
the COBOL compiler included in the 3.01 release of system software, with patch number 08. 


Software items from different releases should not be used together. For example, an interpreter from release 
3.01 should not be used with an MCP from release 3.00. 


This book describes system software relative to the 3.01 release. 


Software Patches 


Within a particular release, patches to individual items may be issued. For example, an MCP identified by 
3.01.12 contains certain improvements over an MCP identified by 3.01.11. A patch always increases the patch 
number. It is always advisable to use the highest patch versions within any one release. All system software 
items within a given release (mark and level numbers) may be used together, regardless of the patch number, 
unless explicitly stated otherwise at the time of release of the item. 


Certain items may be patched by the user. The details are machine-dependent and are described in the rele- 
vent section (8, 9 or 10). 


SOFTWARE SUPPORT 


Throughout this book, suggestions are made for corrective action where possible, following a particular output 
message or symptom of failure. Sometimes the phrase ‘“‘request technical assistance’? has been used. This should 
be interpreted as a recommendation to contact your immediately higher support level if you are not sure of 
what to do or do not feel justified in attempting further action without competent advice. 


All problems with the system should be recorded. This is for two purposes: to report the problem; and to 
avoid similar problems in the future. The report should contain the date and time and list the systems. As a 
minimum it is recommended that the SPO hard-copy printout or SPO log is kept for future reference. 


TO THE READER 


This book is written as reference material. It is a guide to be consulted during operation of any CMS machine. 


This book explains how to start and to stop the system software. As this is normally hardware-dependent, 
the relevent section (8, 9 or 10) should be consulted. 7 


Once the system software has started (that is, the system is under MCP control), the operator may interface 
with the MCP via the SPO (Supervisory Printout) device in order to execute programs. The type of device may 
vary with the hardware product, but input and output messages are standardized. 


Section 2 of this book explains some general terms which should be understood in order to make full use 
of the CMS features. It explains how to cause programs to be executed. This section also explains how to read 
the diagrams used throughout the book to describe the format of input messages and other details. 


Details of input messages are given, in alphabetical order, in sections 3 and 4. The items in section 4 are 


utility programs which are executed in the same manner as other programs. The items in section 3 are embedded 
features in the MCP. Refer to section 2 for a fuller explanation. 
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Sections 5 and 6 describe the sort/merge feature and the compilation feature respectively, and will be of spe- 
cial interest to PICeramnincrs: Section 5 includes a functional description of the sort/merge feature. 


Section 7 lists the messages which may be output to the SPO by the system software during execution of 
the system. As each message is identified on the SPO ye a number, reference to this book can be made by 
this number. 


For other items such as hardware and en software failures, refer to the particular hardware section (8, 
9 or 10) for details. 


SECTION 2 
BASIC CMS OPERATION 


INTRODUCTION 


All CMS operation has two basic principles: it is disk-based; and operator communication is with the MCP 
by a SPO device. Other peripherals may be present, depending on the configuration. This section introduces 
some basic principles which should be understood by all CMS operators. The material in this section is common 
to all CMS products. Other details that are machine-dependent are given in the relevant section. 


PERIPHERALS 


Each peripheral is referenced by a three-character abbreviation, where the first two characters give the type 
of peripheral and the third character refers to the particular peripheral by the letter A, B, and so on. For exam- 
ple, LP is the abbreviation for a line printer, so the first line printer is referred to as LPA, and the second 
is LPB. 


The peripheral types are listed below: 
AC - console with any output device 
AM - any multi-function card unit 
AP - any (serial or line) printer 
AR - any card reader 
AT - any magnetic tape 
CP - any card punch 
CT - cassette tape 
DC —- data communications controller 
DF - fixed disk 
DI — industry-compatible mini-disk (ICMD) 
DK - disk cartridge (any type of speed) 
DM — Burroughs super mini disk (BSMD) 
DP —- disk pack 
LP - line printer 
MT — magnetic tape (reel) 
M8 —- 80-column multi-function card unit 
M9 — 96-column multi-function card unit 
PC — console with serial printer 
P8 - 80-column card punch 
P9 — 96-column card punch 
R8 - 80-column card reader 
R9 - 96-column card reader 
SC - console with self-scan device 
SP —- serial printer (on console) 
SS - self-scan device 
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If the configuration contains more than one device of the same type, the designation (A, B, and so on) de- 
pends on the location of the peripheral controller in the hardware. If there is only one dual-drive cartridge con- 
troller, the upper drive is DKA and the lower drive is DKB. If there is only one dual-drive Burroughs super- 
mini-disk controller (for example, on a small B 80 with in-built mini disk), the upper drive is DMA and the 
lower drive is DMB. | 


The three-character references are used in all operator communication with the MCP (refer to section 3). 


SYSTEM AND USER DISKS 


The MCP resides on a disk unit. At warmstart time (when the system is started up and the MCP begins to 
function) the MCP notes the disk containing the executing MCP code. This) is called the “system disk’’. 


During operation there is only one system disk. Other disks may contain a copy of the MCP code, but only 
the disk from which the MCP is running is the system disk. 


All other disks on the system during machine operation are called “user disks’. 
There is one restriction on the portability of system disks between different CMS products. A system disk 
may not be taken to a different CMS product and used there as a system disk. It may, however, be used on 


the second system as a user disk. It may also be used on the first system as a user disk. User disks may always 
be interchanged between different systems. | 


DISK FORMAT 


A disk consists of one or more platters, one or both surfaces of which may be used to record data. The re- | 


cording area of disks is divided into the following physical items: 


Track: 


An area of one surface of a disk which is at the same distance from the center of the disk. The entire track — 


can be accessed without moving the position of the read/write head. 


Sector: 


The basic unit of disk address, size 180 bytes on all Burroughs disks, and 128 bytes on ICMD. A physical 
read or write uses a complete sector. There are several additional bytes in each sector, used only by the hard- 
ware and not accessible to user programs. The sector is also called a “segment”. 

Cylinder: 

If there is more than one surface, each track at the same distanee from the center makes a cylinder. The 
entire cylinder may be accessed without altering the position of the read/write heads. 


Figure 2-1 illustrates these terms. 
Disk Initialization 


Each disk must be initialized before use on a CMS machine. Initialization creates correct sector addresses 
throughout the disk recording surface, then writes certain data in the low-address part of the disk. The first 
sector is numbered sector zero, and the first track is numbered track zero. A disk with a bad track zero can- 


not be initialized. The method of initializing the disk is machine cepencent Teter to the appropriate section. 


Sector zero contains the disk label. This includes the name of the disk, or “ disk- id’’. Every disk has a disk- 
name. This disk-name can be from one to seven characters, using the set A to Z, 0 to 9, and the dot (‘‘.”) 
and hyphen (‘“‘—” : 
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TOP VIEW : 


ONE TRACK, MADE OF 
SEVERAL SECTORS 


ANOTHER TRAGK., MADE OF THE 
SAME NUMBER OF SECTORS 


SIDE VIEW : 


Lv. ONE CYLINDER 


= en} 
READ/ 
HEADS 
> 4 


Figure 2-1. Physical Disk Structure 
Disk Files 


Information is stored on a disk in a “disk file’. There may be many files on one disk. Each file is referenced 
by a “file name”. A file name can be from one to twelve characters, using the set A to Z, 0 to 9, and the 
dot and hyphen. Each disk contains a directory of the files on that disk. This directory is accessed by utilities 
such as KA and PD (see section 4). 


Information can be of different types: normal data, accessed by programs; special data, accessed by the MCP; 
and programs themselves. The MCP 1s itself a program, and so are other “system files’’ such as the interpreters. 
System files have special restrictions in that a control is placed on their removal (see RM section 4). 


Disk File Names 


On any system, every disk file (whether data or a program) is accessed by a two part reference, as follows: 
disk-name/file-name 


For example, the disk file M101A/REP200 is a file with a file-name REP200 to be found on the disk with 
a disk-name MIO1A. 


It is not necessary to give the name of the system disk when referring to files residing on the system disk. 
Alternatively, a disk-name of 0000000 by convention refers to the system disk. For example, the disk file 
REP200 or 0000000/REP200 is a file with a file-name REP200 to be found on the system disk. 


It is not allowed to have two disks of the same disk-name in use at the same time. It is not allowed to have 
two files of the same file-name on the same disk. However, it is quite permissible for two different disks to 
contain a file with the same file-name. For example, the files M100A/REP200 and M101A/REP200 refer to two 
different disk files (although one may be a copy or update of the other). 
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Disk File Group Names 


In many utilities (see section 4) it is convenient to refer to groups of files, depending on common starting 
characters of their file-names. | : 


All files on a disk may be referenced by the equals symbol (‘‘=’’). For example, the reference M101A/= 
refers to all files on the disk with disk-name M101A. — | 


All files beginning with, say, the characters REP may be referenced by REP=. For example, the reference 
M101A/REP= refers to all files on disk M101A with file-names of REP200, REPA, REP678P, and so on. 


In general, a group-name consists of an equals symbol (“=”) optionally preceded by up to ten symbols which 
are the first part of the file-names of each of the files in the group. | 


Example: 


Consider a disk M101A containing files with file-names: 
PR200,REP100,REP200,REP250,RQ510,CRCOPY 


Then the following group-names refer to the files indicated: 


M101A/= 

PR200, REP100, REP200, REP250, RQ510, CRCOPY 
M101A/REP= 

REP100, REP200, REP250 
M101A/R= 


REP100, REP200, REP250, RQ510 


Disk Directory 


The disk directory is a table on every CMS-initialized disk which enables the MCP to locate any disk file by name. Full 
details of the directory layout are given in the CMS MCP manual. | 


The directory is a fixed size determined at disk initialization time, based on the maximum number of files 
to be placed on the disk. An attempt to create more files than there are entries in the directory will give 
an appropriate MCP run-time error message, | 


The directory consists of three parts: 
the name-list | 
the disk file headers for each file 
the available table 


The relationship between these parts are given in figure 2-2. The name-list is a list, by filename, of each 
file existing on that disk. A search through this name-list will reveal if a file is present or not: if present, the 
name-list entry points to the disk file header for the file. This is a table giving the location of each part of 
actual data in the file (the file may be divided into up to sixteen separate physical areas on the disk). In the 
figure only one area is indicated. The available table is a list of the disk areas not in use by a file. When a 


new disk file is created, an available space is found from this table and an entry made in the name-list, then. 


the space is used to write the file information. When a disk file is removed its entry is deleted from the name- 
list and the areas specified in the disk file header are entered in the available table. 


If there is insufficient space on a disk to allocate new disk file areas, a “NO USER DISK” message is given 
by the MCP. The operator may remove a file (see RM) to make more space available. The KA utility (see 
section 4) and KX function provide information on the available space on a disk. | 


2-4 


TRACK 0 


DISK LABEL 


DIRECTORY | AVAILABLE 


DISK FILE 
HEADERS 


NAME-LIST 


DISK SPACE 
FOR FILES 


Figure 2-2. Disk Directory Structure 


As a simplification, it may be stated that when a disk is initialized the directory is rebuilt with no entries, 
indicating that the entire disk space is available apart from the directory itself. In fact, any bad areas on the 
disk are marked in the directory so that they cannot be allocated to files (see also the XD utility); also, there 
is a special entry called “SYSMEM” which enables certain programs such as PD and RM (which access the 
directory) to operate successfully. 


Indexed Files 


Indexed files are in fact a pair of files, the“‘key file” and the “data file”. They may reside on the same or 
separate disks. Each file in the pair has a separate entry in the disk directory of the disk on which it resides. 
A special table at the beginning of the key file (the“‘key file parameter block”’) gives, among other information, 
the disk-name and file-name of the associated data file. See figure 2-3 for a diagram of the relationships between 
the two files. | 


The purpose of indexed files is to simplify access to data in the data file by using a set of keys (such as ac- 
count number) in each record of the data file. These keys are placed in the key file. A key file may be created 
by the SORT utility and intrinsic (see section 5, where examples are given). 


Special consideration must be given to copying indexed files, due to the link between the key file and data 
file. This is especially true when copying from one disk to another. Details are given in each relevent section 
(see COPY utility, section 4; also the machine-dependent copy facilities). 


Dual Pack Files 


As mentioned before, a disk file may be divided into up to sixteen separate areas. If these areas are located 
on two separate disks the file is known as a“dual pack file’. Such files may be created by the AD intrinsic 
in response to a““NO USER DISK” message (see section 3). 


There is an entry in the directories of both disks for a dual pack file, together with the disk-name of the 
other disk. Each disk directory has a copy of the disk file header for this file, but the table of locations for 
each file area also indicates if the area is located on“this” disk or the‘‘other” disk. This is shown diagrammatical- 
ly for a file with four areas in figure 2-4. In most applications it is necessary for both disks of a dual-pack file 
to be on-line at the same time. 
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DISK LABEL OF DISK 
WITH DATA FILE 


DIRECTORY ENTRY 
FOR KEY FILE 


DIRECTORY ENTRY 
FOR DATA FILE 


DATA FILE 
DISK-NAME 


DATA FILE 
FILE-NAME 


KEY FILE , DATA FILE 


Figure 2-3. Indexed Files 


DISK LABEL OF DISK 


DISK LABEL OF DISK 
A : 


DIRECTORY ENTRY DIRECTORY ENTRY 
FOR DUAL-PACK FILE | FOR DUAL-PACK FILE 


DISK A DISK B 


Figure 2-4. Dual-Pack Files 


MAGNETIC TAPE FILE NAMES 


Note: this includes tape cassette. 


A tape may be used to store data either on one file (a “‘single-file tape”) or as a “‘multifile tape’. Each file 
is separated by a tape mark. Additionally, each file normally has a beginning and an ending label. A multifile 
tape has also a special beginning (‘“‘volume’’) label. 


On loading a tape, the MCP reads the first label to determine the tape name. Tape file names are in two 
parts: 


multifile-name/file-name 


For a single-file tape, the multifile-name will be “0000000”. The format of the multifile-name is the same 
as for the disk-name of a disk file. 


The COPY utility (section 4) produces a single-file tape when copying to tape. The LD utility (section 4) 
always produces multifile tapes called “library tapes”. Library tapes are referenced by the multifile-name: there 
is a standard convention for labelling all the files on a library tape. For full details of tape formats, refer to 
the CMS MCP manual. 


Tapes (multi-file or single-file) may be unlabelled. Such tapes must always be accessed via the AD intrinsic 
(section 3) because there is no label that the MCP can recognize when the tape is loaded. Tapes containing 
labels that are non-standard are also treated as multifile unlabelled tapes. 


PRINTER FILES 


There are two types of printer: a wide line printer and a console printer, depending on available hardware. 
The console printer is also known as a “‘serial printer”. These hardware devices are also referred to as “files” 
and are given file-names of up to seven characters. When the file is opened and closed, an identifying print 
line is given to indicate the name of the file. This file-name is also used in MCP messages. Refer to the CMS 
MCP manual for full details. 


It is possible to designate a file type of “‘any printer”. Such a file will be written to a wide line printer if 
this peripheral is available. If not available, this file will be written to the console printer if available. If there 
is no console printer either, the MCP will display a “NO FILE” or “DEVICE REQUIRED” message. 


OTHER PERIPHERALS 


All peripherals are treated as files for input, output or a combination of input/output, depending on the hard- 
ware type. The use of any periphral device is governed by the file-name of up to seven characters, which will 
appear in any related MCP messages. Refer to the OL intrinsic (section 3) for other details. 


PROGRAMS 


An executable program is information stored on disk as a disk file. It is referenced in the same way as any 
data file: that is, through the disk-name and file-name (or just the file-name if the program resides on the system 
disk). The rules for the program name are the same as for any disk file name. 


A “utility” is a program provided for general use by all CMS operators, for house-keeping and other general 
purposes. For example, the LD utility enables operators to load and dump disk files from disk to magnetic tape 
for backup purposes. 


Executing Programs 


In order to execute a program, part or all of the information in the disk file must be brought into memory 
and placed under control of the MCP. This is called “program load‘, and takes a certain interval of time. 


2007258 227 


Programs may be loaded and executed by merely providing the name of program file to the MCP. If so de- 
sired, the keyword “EX” may be place before the program name. For example, suppose one wishes to execute 
a program that resides on a disk PR200A in a file called DCS. Either the mips 


EX PR200A/DCS 


or just 
PR200A/DCS 


will cause the program to be loaded and executed. 


Depending on the system, a BOJ Geoamneor job) message may be displayed by the MCP after the program 
_ has been loaded, and a EOJ (end-of-job) message may be displayed by the MCP at the end of the program. 
The display of these messages may be turned on or off for individual programs by the MODIFY utility (see 
section 4). 


Failures may occur when attempting to load a program. For example, the requested program may not be on 
disk. A list of load failure messages is given in section 7. 


Many programs enable the operator to enter further information after the program name. This is known as 
an “initiating message” and the contents are entirely dependent on the program. Nearly all the utilities in section 
_ 4 allow further information, the format of which is given in the description of each utility program. For example, 
the input 


COPY REP202 TO RPTAPE 


consists of the command to load and execute the program called “COPY” (found on the system disk in this 
example), followed by the information ““REP202 TO RPTAPE” which is passed to the program. There are two 
types of error which can be made: either there is a load failure (because, for example, the COPY program 
is not on the system disk), when the MCP would issue an appropriate message; or the following information 
is an incorrect format for the program, when the program itself would issue a message. In the former case, 
the MCP message is described in section 7. In the latter case, the output message is described under each utility. 


Note that if the utility resides on, say, the disk PR2, the input message would be 
PR2/COPY REP202 TO RPTAPE 


OT . 
EX PR2/COPY REP202 TO RPTAPE 


In section 4 this additional information is omitted in the interest of clarity. It is, however, common for utilities 
to reside on a disk other than the system disk, in which case the disk-name must be provided. 


It 1s also possible for programs to be automatically executed by another program. In this case, the first pro- 


gram is said to “zip” the second program. No operator input is used in this case, but the BOJ message may 


be displayed for the zipped program. 
INTRINSICS 


There is an important type of operator input that does not involve a command to execute programs or 
utilities. These messages are calls on “‘intrinsics”’ which are part of the MCP. Those intrinsics which are common 
to all CMS machines are described in section 3. Other intrinsics are given in the relevent machine-dependent 
section. 


Because an intrinsic is part of the MCP, there is no separate program corresponding to the name of the intrin- 
sic. Therefore the keyword “EX” is not allowed in a call on an intrinsic, neither can a user disk-name be 
specified. There is no program load time because the MCP is already executing. For ada the input 


RY DMA 


is a request to the MCP to ready (RY) t the disk petipheral designated yt DMA, This input message to the 
MCP must not be preceded by the keyword ‘EX’’. 
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MIX NUMBERS 


As a program is loaded, the MCP assigns it a number from its table of executing tasks. This is the ‘“mix- 
number” and is used in any messages output by MCP relating to this task. The mix-number is also used in 
all messages input by the operator for this task. Some input messages also require the corresponding program 
name as well as the mix-number. The MX intrinsic (see section 3) may be used to determine the current mix 
of tasks. 


The allocation of mix-numbers is dependent on the CMS product. Refer to the corresponding section for more 
details. | 


OUTPUT MESSAGES 


As mentioned earlier, messages may be output on the SPO either by the MCP and other system software 
or by the program. It is important to distinguish between the two types of output messages in order to look 
up the message in the appropriate place. 


Messages output by the MCP are of two kinds: short responses to intrinsics, and longer descriptions of any — 
event to be brought to the attention of the operator. The short descriptions are self-explanatory: for example, 
the input message 


OL LPA 


(an intrinsic to inquire of the status of line printer LPA) may result in the response 
LPA READY 


Similarly, the short message 
LPA NOT READY 


will be displayed if LPA is stopped by the operator or through any fault. The longer descriptions are always 
referenced by an “event number” enclosed in brackets. The format of these messages is given in section 7, and 
operators should’ be generally able to recognize that such a message has been output by the MCP. 


For example, the message 
10/LIST <17> WAITING UNLAB LISTPRT AP NO FILE 


indicates an MCP message with event number 17, and reference should be made to section 7 for information 
on possible causes and suggested actions to take. 


Messages with event numbers may also be output by other parts of the system software such as interpreters 
and the sort-intrinsic, although the overall format is similar. After recognizing the event number, reference 
should be made to section 7 (or section 5 for sort-related messages). 


Messages output by all other programs are known as “displays” and may be preceded by the keyword 
“DISP”. Note, however, that utility programs may display messages without this preceding keyword. 


All messages output by the utility programs described in this manual are listed under the respective utility. 
For example, messages displayed by COPY utility are listed under the COPY utility. Messages may additionally 
be displayed by the MCP for events related to the execution of the COPY utility (for example, if the COPY 
utility needs space on a particular disk, a “NO USER DISK” message will be output) but these MCP messages 
will always be distinguished by the event number. | 


Messages displayed by other programs are not discussed in this manual. Reference must be made to the ap- 
propriate manual or operating instructions for that program. | 


Figure 2-5 illustrates a sample SPO list giving a mixture of messages described in this section. Note in this 
example that the utility programs LIST and LR do not give rise to BOJ and EOJ or DISP messages. The user 
program PROGA shows all three messages. These messages may be turned on for utilities by using the 
MODIFY utility (section 4). 
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input commanc to run LIST <--> LIST COLLETTE tg | ©} 
MCP gutput message event 10-> O1/LIST <1¢> WAITING COLLETTE Dk NO FIL | . 
input command to run PFOGA => PROGA 
CP message for PROGA BOJ ==> O2/PROGA BOJ PR Is A 
input commanc to run LR er-"> LR = : 
next Line is PROGA cisplay *> O2/PROGA DISF:s _ 
jactual display infermation => PROGRAM A MER STON 7201-05 
jinput request Gt intrinsic => OL LFA . 
MCP response to OL message “> LPA LRPRINT IN USE BY C3/LR 
input request MX intrinsic -> MX | : | | 
MCP response to MX message “> C1L1/LIST SUSPENDED WAITING CN AC FILE 
7 “> ee eCONDITION | 

=> O2/PROGA A EXECUTING 

-> C3/LR B EXECUTING 
MCP message for PROGCA EDJ => OZ/PROGA ECJ 
input request ST intrinsic -> ST 3 
MCP respcnse to ST nessage => O3/LR STOPFED 


Figure 2-5. Sample SPO List 


| FORMAT DIAGRAMS 


Most of the descriptions of input messages in this book are given as simple ‘outa diagrams with correspond- 
ing descriptive text and examples. An example will illustrate how to read such format diagrams. 


Example: ne | ! | : ®@ 
=| disk-name / Vv {: TST200 } number | 


TST201 


In this format, items in lower-case (“disk-name”’ and “‘number” in this example) are to be replaced by actual 
values (such as “PR2” and ‘27’). Other items are included in the input message as they are found. Spaces 
are required whenever necessary to avoid ambiguity. In the example, it is not strictly necessary to separate the 
disk-name and the slash (“/”) with a space because the slash cannot be part of the disk-name according to the 
rules for disk-names. Extra spaces may however, be added for legibility. If an arrow in the left-to-right direction 
is encountered, the items under the arrow may be omitted. Curly brackets are used to denote alternatives. The 
alternatives are placed in a list underneath each other. (Each alternative item may be more complex than the 
example quoted: it may contain optional parts and further alternatives). If an arrow in the right-to-left direction 
is encountered, one may return to the point underneath the arrow and continue building up a valid input mes- 
sage In the example quoted, after adding a valid number (say “‘27”) one may return to add a second number 
(say “‘52’). In fact, the format diagram does not specify how many times one may continue to do this, but 
details are given in the text. | 


Here are several valid input messages which can be generated from the example (Note that a dislecname can 
consist of up to seven characters, see earlier): 


EX TST200 57 

-EX TST201 259 | 

EX PR2/TST200 36 ; | ; ® 
EX PR2/TST200 2 52 574 361 = | 

EX M101A/TST201 12 — 


2~10 


‘Here are several invalid input messages according to the example: 
| EX PR2/TST200 
EX PR2 TST200 36 
EX TST202 36 
TST201 259 
EX PR2/MIOLA/TST201 1 2 


Here is a slightly more complicated example, which makes the number or list of numbers optional: 


EX | disk-name / 1 am | number | 


Example: 


TST201 


The input messages 
EX PR2/TST200 
EX PR2/TST200 56 
EX PR2/TST200 27 56 


are now all valid. 


These simple format diagrams are easy to understand in conjunction with descriptive text and examples, but 
cannot be used if the format becomes too complex. In the latter case a rigorous notation known as “railroad 
diagrams” is employed (see below). In some case in the text of this book, the format has been deliberately 
simplified for the sake of clarity, with further details given in the text. More complex features have been de- 
scribed by railroad diagrams (see, for example, the COPY and LIST utilities in section 4). Appendix B gives 
complete railroad diagrams as a handy reference for those who need the exact definition of any input message. 


RAILROAD DIAGRAMS 


The equivalent railroad diagram to the first format diagram is given in figure 2-6. 


<disk-name> — / 


TST200 
EX < number > 


TST201 


Figure 2-6. Railroad Diagram Sample 1 


To form valid input, follow the railroad ‘‘track’’ from left to right or in the direction of the arrows. A junction 
in the track indicates that alternative paths may be followed. Items enclosed in angled brackets ““<” and <>?) 
must be replaced with actual values, as before. Each item not enclosed in angled brackets is included as it is 
found. Spaces are added where necessary, as in format diagrams. 


The equivalent railroad diagram to the second format diagram is given in figure 2-7. 


<disk-name> ~~ / < number > 


TST200 
EX 
TST201 


Figure 2-7. Railroad Diagram Sample 2 
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There are two other features available in railroad diagrams to make possible the exact specification of any 
input message. These are illustrated in figure 2-8. Pily; the maximum number of times around a loop may 
be controlled by including the number | 


<disk-name > — 
TST200 


TST201 


Figure 2-8. Railroad Diagram Sample 3 


in the track of the loop. In the example, it is possible to omit the <number>, or to include either one or 
two values of <number>. Secondly, if angled brackets are to be included as part of the message, these must 
be underlined. In the example, there is an optional part of the message which consists of the three characters 
“<A>”. The following messages would then be valid: 


EX PR2/TST200 

EX PR2/TST200 27 

EX PR2/TST201 27 56 
EX PR2/TST201 <A> 
EX PR2/TST200 <A> 56 


but the following would be invalid: 
EX PR2/TST200 27 56. 243 
EX PR2/TST201 A 
EX PR2/TST201 A 73 


Note also that if a number under a loop is preceded by an asterisk (“ * ”’), then that loop must be included in the syntax 


at least the number of times specified. For example, if the loop included the characters “ *1”, then the loop must be included. 


at least once. 
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SECTION 3 
CMS-COMMON INTRINSICS 


INTRODUCTION 


This section describes, in alphabetical order, those input commands which are embedded in (“‘intrinsic to’’) 
the MCP, and which are common to all CMS products. 


As discussed in section 2, it is not valid to precede these messages with ‘““EX’’, because the intrinsics are not 
separate programs to be loaded and executed. The intrinsics cannot be executed from a user disk, because by 
nature they are part of the MCP which is on the system disk. 


The response to these intrinsics may vary slightly between different CMS products, due to different hardware 
being used. These variations have been noted in the text where applicable. 


AD (Assign Peripheral Device) | | @ 


This intrinsic allows the operator to assign a particular peripheral to a program that has called for an “unla- 
_belled input file”, or that requests a particular output device. 


It may also be used to allow file overflow onto a second disk if no disk space is available 


AD mix-number | /program-name peripheral 


Format: 


Example 1: 


Copy utility requires another disk: 


COPY INIST TO INDISK3/INIST 
10/COPY <12 > WAITING FILE10.NO 
... USER DISK | 

AD 10 DMB 


(The first message is output by the MCP and the operator responds with the AD message by assigning DMB 
as the disk to which the remainder of file INIST will be copied. This creates file INIST as a “‘dual-pack file‘). 


Example 2: 
Program “COBOL/7”, mix number 03, requires a line printer type device: 
03 COBOL7 <17 > WAITING LP NO FILE 
AD 03 LPA 


(The first message is eee by the MCP, and the operator responds with the AD message by assigning LPA 
to mix number 03). 


Example 3: 


The LIST utility requires an unlabelled tape: 
LIST TAPE1 MTP NO.LABEL 
01/LIST <14> WAITING UNLAB SPURIUS/TAPE1 AT 
... DEVICE REQUIRED | 
AD 01 CTB 


Output messages: 


MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 
mix rumber/program Specified program Check with MX 
AC INVALID 3 was not suspended for rame of susp ended 
waiting for a cevice progrémr. rd 


assSionmert. 
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AX (Accept a message for a program) 


This intrinsic allows the operator to communicate with a program in the mix. The program must already be 


suspended waiting for an “accept” (ACPT). 


The MCP will prompt the operator for input by printing ‘mix number/program-name ACPT” on the SPO. 


The maximum length of the “text” or operator input is 50 characters. Operating intructions for individual 


programs will provide the operator with valid “text” responses. 


Format: 


AX mix-number | / program-name | text 


Example: 


The program BM001 displays a message asking for a file name to be entered. The operator responds with 


the appropriate text, in this case ARSCHG, by the AX message. 


<~ BMO01 
01/BM001 BOJ — 
ENTER BM202 FILE NAME 
01/BM001 ACPT 
~- AX 01 ARSCHG 


Output messages: 


POSSIBLE CAUSES 


mix"number / Specified croqram 
program~name AX Was not wWaitine for 
INVALIO an “accept™ | 
or 
mix number and 
specified program 
Nare do not matck. 
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SUGGESTED ACTICN 


Check with MX for 
proper mix=nunter 
enc Crogram"nete 
combinéticn. 
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CL (Clear Peripheral) 


This intrinsic allows the operator to clear the peripheral from the program and bring the program to End 
of Job (EOJ). It breaks the “links” between the program and the peripheral. 


For example, if the line printer “hangs” during the printing of a report and an attempt is made to DS the 
program, it will not be possible to discontinue the program unless the line pantera is made ready or CL ts used 
to break the ‘link’ between the program and the line printer. 


Format: 
printer peripheral 
CL a tape peripheral 
self-scan peripheral 
ICMD peripheral 
Examples: 
CL LPA 
CL SSA 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTICN 


Proaqras iS not waitirg Check input. 
on “hung™ peripheral. 
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DC (Data Communications operator input) 


This intrinsic enables the operator to enter messages from the SPO to the Message Control System (MCS) 
if data communications activity is in process. The message text, after being stripped of the “DC” characters and 
the following blank character, is transferred to the MCS input message queue and marked as “‘operator input’. 


The interpretation of the message text is defined by the particular MCS. 


Format: 


DC | text 


Example: 


To enter the text “MAKE STATION 2 READY‘: 
DC MAKE STATION 2 READY 


Output messages: 


POSSIBLE CAUSES 


MCS irput successful 


pc INVALID no MCS in the mix 


DC NOSPACE There iS ro available 
| message space in 
memory for this. 
message 
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SUGGESTED ACTICN 


check input? execute 
the MCS 


wait a short time ther 
revirput messeces if 
unsuccessful several 
times» requast 
techrical assistance. 


DP (Discontinue and Dump) | 


_ This intrinsic is similar to the “DS” intrinsic. The difference is that the disk work space (Virtual Memory 
on Disk, Virtual Disk) is not freed up and returned to an available status. : | | 


The disk work space is, instead, updated from memory with all the most current information about the pro- 
gram. The disk backup is then made into a file (locked) and given a name, “DMFILnn” (‘nn” is the mix number | 
for user programs, utilities, and MCP intrinsics). : 


The peripherals and memory in use by the specified program are made available to other programs. 


DP is used when a technical analysis of a particular program is required following a failure during its 
operation.  —s_. aS | : : 


Format: pee ‘DP mix-number/program-name 


Example: 


DP 01/GL060 


Output messages: 


MESSAGE | POSSIBLE CAUSES SUGGESTED ACTICN 


mix number/program- DP successful 
name DP'ed | | 


input INVALIC | mix nugber does rot Check Input Creinput 
| correspond to if necessary). 
pregram name | | or 


Check with MX for 
Proper mix number and 
Frogramt name comtinat= 


Ione 


linput INVALIC - program“"name is Check with MX enc 
JINEEOS PROGRAM=ID- missing | re~irpet. 
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DS (Discontinue Program) 


This intrinsic causes the orderly termination of the specified program. All peripherals in use by the program 
are made available to other programs. 


Format: | 
DS  mix-number / program-name 


Example: 


To terminate the program ARO40 which has mix number 2: 
DS 02/AR040 


Output messages: 


MESSAGE © POSSTPBLE CAUSES SUGGESTED ACTICN 


mix/erog OS'ed 0S successful | none 


input INVALID mix number does rot check with MX» 
correspond to proor an reingut 
namesy or procrém is 7 
an MCS. 


input INVALIC-NEEDS program name not check with 4X» 
PROGRAM I9 specified reingut 


Note: if the program is waiting on a “hung” peripheral device, try the CL intrinsic. 
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DT (Systems Date and Time) 


This intrinsic allows the operator to inquire about or change the system date and time maintained by the 


MCP 
Format: | 

DT | mm/dd/yy | hhmm 
Examples: 


To inquire about the system date (and time if the System contains a real time clock) 
DT 


To change the system date: 
DT 01/01/78 


To change the system date and time: 
DT 03/23/78 1234 


(March 23, 1978 is the new date. 12:34 is the time). 
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Output messages: | 


POSSIBLE CAUSES 


"DD MON YY YYODD Normal response 
HHMM DOW" tea. “DT. 
where 
DO = day of month 
MON = 2 letter 
abbreviatior of 
month. 
YY = year 
YYDO0C = Julian date 
HHMM = time Chours 
and minutes) 
OOW = day of week. 


<INVALID DATE> Ar error was made 


in one of the follow" 
ing fields: 
MM 


DD 
YY 
For example = 4 
MM entry of "0" or 
greater than 12 
is invalid. 
The entire déte is 
rejected» tut a4 
valic time entry 
in the same mess- 
age wilt be aeccept= 
ed. 
<INVALIOD TIME> A time greater thar 
2359 was entered. 


The tine 18 rejected. 
A valic date entry in 
the Same messace witl 
be accepted. 
<NO CLOCK> Time entry was 
| maces but system 
has no reat*time 
clock. 


Valtic date ertry 
will be accepted 
in Same message. 
MM/OC/YY HER?MM Normal resconse 
to 9T inquiry 
C(B80C) 
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SUGGESTED ACTION 


rone 


Feincut date 
portion of 
NeSSace 


Reinert time 
portion cf 
mreSsece. 
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FD (Form Define) 


This intrinsic allows the operator to define a logical page for a serial printer (SPA) or set top of page for 
the SPA. | : 


Unless the operator indicates otherwise, the current position is taken as the top of the page. 

If the three parameters (HEIGHT, WIDTH, and OFFSET) are specified, then they are used to define a 
logical page on the SPA. HEIGHT specifies the number of lines on a logical page; WIDTH the maximum num- 
ber of characters in one line; and OFFSET the number of characters that the printing area is to be offset from 
the left. An OFFSET of zero specifies the left-most physical position. 

WIDTH and OFFSET added together must not be greater than the number of physical print positions on 
the serial printer. For example, if the physical printer has 255 columns the maximum printing area is given by 
a WIDTH of 255 and OFFSET of zero. The logical page will remain the same as defined by FD or next warm- 
start. | 


Format: 
FD SPA | height, width, offset 


Example: 


FD SPA 66, 120, 5 


defines a logical page on SPA where height is 66 lines and the printing area is 120 characters wide offset 
5 columns from the left (that is, from columns 6 through 125, numbering the left-most column as column } 


Output messages: 


MESSAGF POSSIBLE CAUSES SUGGESTEE ACTION 


FO SPA numbers FD specifications Creck input ard re- 
INVALIO | for heicht» wicth» enter. 


and/or offset ére 
not acceptable. 
Attempt to print 
heyond SPA capabil- 
itilese | 
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GO (Restart a Stopped Program) 


This intrinsic allows the operator to restart a program which has been stopped with the “ST” command. 


GO mix-number | / program-name 


Format: 


Examples: 


To restart program whose mix-number is 3: 


GO 3 


To restart program PRO20: 
GO 3/PR020 


Output messages: 


MESSAGE 


mix*rumber/orog "name 
NOT STOPPES 


mix"number/prog=name 
INVALID 
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POSSIBLE CAUSES 


Specified program 
WaS not waitinc 
for a “GO" commara. 


Optional orogram 
name Was uSec anc it 
did not match the 
mix number srecified. 


WOT HECESD Hy Zo USO PEO C6 Ain NAtuE 


SUGGESTED ACTICN 


Check with MX for 


Suspenced progranr 
waltirc for "GC" 
reéingut. 


Check with MX for 
correct W1x number 
énc métching procrem 
réwe. Retnput. 
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MX (Display Current Mix) 


This intrinsic allows the operator to inquire about the status of any program(s) currently processing. 


MX | | mix-number : | / program-name | | 


Format: 


Examples: 


To inquire about all programs currently processing: 
MX 


To inquire about a particular program: 
MX 03/PR020 
or MX 03 


Output messages: 


PROBABLE CAUSES SUGGESTED ACTICN 


INVALID MIX Specified progran Creck input Cretingut. © 
| is not currently if necessary). 
running. 


No programs are 
currently proc” 
eSSing.e 


INVALID FROGRAM ID Optional program Re-trput 
name was used anc 
it did not meétch 
the mix number 
specified. 


For each program specified, the following information is provided: 


MIX NUMBER 
a number assigned by MCP to this program as it was loaded into memory. 


PROGRAM NAME 


PROGRAM PRIORITY - “A”, “B” or “C” 
A 


II 


lowest priority (that is, application program) 


B = medium priority (that is, system utility) 
C 


highest priority (that is, data communications) 
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STATUS OF PROGRAM 


EXECUTING - program processing normally | 


SUSPENDED WAITED ON - program processing was temporarily halted. For reasons, see chart below. 
waiting on a resource (that is, Virtual Memory or I/O buffer) which 


SHORT WAITED ON - program is 
the system can guarantee will be ma 


SWAPPED OUT WAITED ON - portions of this 


de available in a relatively short time. 


previously suspended program were temporarily removed 


from real memory and returned to disk. Memory space was required for other programs in the mix. (Reasons 
for “swap outs” are same as for program suspension). 


Possible messages are summarized by the chart below: 


mix / program 
numbder name 


Output message examples: 


MESSAGE 


C4/PR060 A EXECUTING 


O4/PRO6C A SUSPENDED 
WAITED ON O/C 


O4/PFO59 A SUSPENDEC 
WAITED ON VM 
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pricrity 


EXECUTING 

SHORT WAITED ON 

SUSPENDED 
WAITED OA 

SWAPPED OUT 
WAITED ON 


POSSTS8LE CAUSES 


Program processing 


normally 


Pregram is waiting or 


a fite open or ctosee 


Program is waiting 
on Virtual Memory. 


n/c 

VPM 

SCL TASK 
CPERATCF INFUT 
ACCEPT 

ZF 

T/C OR EVENT 


NC OISK FILE CAG FILED 


DUPLICATE FILE 
SYSMEY FILE 

NO USER DISK 
DIRECTORY SPACE 
DEVICE (NO FILE) 
GC COMMAND 

EVENT TIMER 


SUGGESTEC ACTICN 


None = program will 
Ce résumed when fite 
fas teen crenec or 
closed. 


More ? do not try to 
execite too mény prog 
rams at this time. 
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POSSIBLE CAUSES) 

Progras is waitirg 

for a “command™ from 
the MCP to be completed 


O4/PRQO60 A SUSPENDED 
WAITED ON SCL TASK 


Csuch 8s résponseé to an 


"OL" input). 
Program is waitirg for 
sore input from coeret* 
ore CFEX:3 A program 

previously suspended 
by ST requires a Gf 

commenc to cortirue). 


oe See: 


10/LR B SUSPENDED 
WALTED ON OPERATGR 
INPUT | 


08/GL060 A SWAPPED 
OUT WAITED CA ACCEFT 


Program has disolayec 
an “ACPI” message on 
SPQ and is waiting for 
appropriate response. 


O5S/AP020 A SUSPENDED 
WAITED ON ZIP 


Program requestec 
assistance of anoth 
program in order to 
complete this jot. 
MCP will automatic~ 
ally toad into memory 
the necessary prog 
ran(s). 


Usually incicative 
of normal process” 
Ince involving I/D 
activity te cisk or 
pertpheratl. 


04/PRO60 A SEORT 
WAITED OA I/C 


Program needs (Card 
has not founc) a 
particular file in 
order to Continue 
precessing-s 


OS/PFO20 A SUSPENDES 
WAITED CN AO OISK 
FILE 


C2/PRO20 A SUSPENDED 
WAITED GN DUPLICATE 
FILE 


Program is attempt- 
Ing to place a file 
of a certain name 

on disk. However» 
another fite cy the 
same nane currently 
resides on adiske A 
disk may not contain 
2 fites with the 

ame ame eo 
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SUGGESTED ACTION 

None = program wilt 
te resumed when SCL 
task has completed. 


Provice program with 
ecprceriate irput. 
Frogram will contirue 
processing. 


Refer to this program's 
operating instructions 
for suggested responses 
to ACPI. Then enter AXx>s 
mix number anc setect> 
ed response. 


Nore. 


Check SPC for message 
indicating name of file 
this program is seekirg 
Then supply missing 
file (COPY fron 

bFeckup meCcium or 

create 1t). If in 

coubt refer to 

crogram instruct 

ions. 


KRormelty» remove 

the existing file 
from cisk with RM. 
If in coubt» refer 
to proecram instreuct- 
Tons « . 


. 5 
s 


. {MESSAGE 


10/COPY 6 SUSPENDEC 
WAITED ON DIRECTORY 
SPACE 


10/COPY B SUSPENDED 
WAITED ON NO USER 
NTIS 


1O/LIST & SUSPENDEL 
WAITED ON SYSMEM 
TLE 


/1C4/7PF0690 A SUSPENDED 
}}WATTED ON NO FILE 


EEO 


F800 


O4/PRO69 A SULSPENDEC 
WAITED CN CEVICE 
2800 


O2/LF B SUSPENDED 
WAITED ON GQ COMMNE 
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POSSIBLE CAUSES 

When the disk was 
initialtzec the disk 
directory was constr- 
ucted to contain a 
fixed number of file 
namese The directory 
has now reachkec 1ts 
Capacity. 


There tS no more 
available space on 
disk* or space avail- 
able is insufficient 
to holo the file the 
System 1S attenpting 
to writes or disk ts 
"checkertoearcec™. 


SYSMEM file cannot 
be Located. 


Device that a frooran 
needs in order to 
continue processing 
1s either unevail” 
able or not reacy? 

or 


Program needs Carc 
has not found) a 
particular file tf 
order to continue 
processing. 


Device that a prograr 
needs in order to 
continue processine 
iS either unévéeil=- 
able or not ready. 


Program was suspend- 
ed by ST command. 


SUGGESTED ACTION 
Remove with RM any 
unnecessary files and 
crograr will continues; 
or DS the suspencec 
crogran. Repléce 

cisk with another 

disk having sufficient 
cirectory soaces anc 
remexyecute the orocrar. 


bith KA» analyze amourt 
cf available sface 
rematininge If cisk is 
filled remove with FM 
eny unnecessary fitess 
cr if cisk 1s fillec 
anc é€ duat“pack file 

1s desired» assign a 
cifferent Ccisk to this 
fFrograr (see AD intrin- 
sic)s cr if disk is 
cteckerboardecs use 

SC utility te consol- 
idete Gdisk spéce» then 
re~execute program 

that encountered 
suspension. 


Request technical 
essistencee 


KY required device; or 
@éssicn procram to at7 
terneive device (see 
AL intrinsic). 


Check SPC for messéce 
indicating name of file 
rrograr is seekirg. 
Supply missing file 
(CCPY from backup sred- 
Tum cr creeéete). 


RY ré€quired device; 
cr assigr crocramr 

to alternate cevice 
(see AC intrinsic). 


Tyce “CGO" clus mix 
number of suspended 
crogrét®. 
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OL (Request for Status Information of Peripherals) 


This intrinsic allows the operator to request the status of peripherals on the system. 


OL | peripheral 


To display status of all system peripherals: 


Format: 


Examples: 


OL 
To display status of a particular peripheral: 
| OL DKB 
OL LPA 
Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


cericherat NOT Peripheral is rot Check tnput Creingrut 
READY on the systems if necessary ) 
Peripherat may héve Reéecy peripheral 


been “saved; if necesSary. 
periopheralt may not 
be correctly tcacec. 


OL oeripheral peripheral is not | rone 
NOT CN SYSTEM configured on machine 


OL peripheral | A ronwmexistant device Creck input 
INVALID has teen specified Creirput if 
(that is» CL CCC) recessary). 


Other output messages produced by OL depend upon type of peripheral. Refer to the following examples 
for details. 3 


Examples of disk device output: 


The general format of the output message is: 


SYS DISK number of 
disk-peripheral disk-name / NOT READY files FILES OPEN 
| PO’D | currently : 
in use | 


Examples: 
DKA AR1/0 FILES OPEN 
DKB AR2/SYS DISK 2 FILES OPEN 
DMA PRA/NOT READY 0 FILES OPEN 
DKA AR1/PO’D 0 FILES OPEN 
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‘Examples of magnetic tape device output: 


The general format of the output message is: 


NOT READY 
multi-file name 
magnetic tape device file name 
UNLABELLED 
PURGED 


or 


multi-file name | ) 
; NOT READY 
magnetic tape device file name + : } IN USE... 


UNLABELLED SAVED 


eee BY mix-number / program-name 


Examples: 
CTA NOT READY 
CTA ARTAPE | 
CTA ARTAPE/IN USE BY 10/TAPELR 
CTA ARTAPE/NOT READY IN USE BY 10/TAPELR 


Examples of output from any other device: 


The general format of the output message is: 


peripheral NOT READY 


ofr . 
multi-file name | i} 
peripheral file name NOT READY IN USE... 
UNLABELLED _ SAVED | 
e ee BY mix-number / program- name 
Examples: 


LPA NOT READY 

LPA NOT READY IN USE BY 04/PR020 
SSA SAVED 

SPA SAVED IN USE BY 06/PR060 
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PG (Purge Tape) 


This intrinsic allows the operator to purge (erase) magnetic tape and cassette tape files, thus labelling them 
as available for output. 2 


Format: 


PG __ tape or cassette peripheral 


Examples: 


To purge a cassette tape on drive CTA : 
PG CTA 


To purge a magnetic tape on drive MTC : 
PG MTC 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


PG successful. 


peripherat not Femirput messece 
specified in messace- & 


PG peripheral Tape could not be Meke certain red tabs 
INVALID purged» as it 15s cn tcp of cassette are 
| "write inhibited™» turned tinward;s make 
or peripheral is certzéin “write permit 
not on the system. ring” is Inserted ir 
tape. Fetry FE. 


Note: if an steanet is made to purge a tape which is in use, then the response to the OL message for that 
peripheral is displayed. 
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PO (Power Off a disk) 


This intrinsic allows the operator to “logically” power off a disk (instruct the MCP that the disk is no longer 
required). At any time when the MCP is idle it is valid to logically power off the system disk with the PO 
. command. This will cause the MCP to terminate. All systems disk files will be closed and SYS-SUPERUTL 


will go to End of Job (EOJ). 


No disk should be removed from the disk drive, no disk units should be powered down, nor should the main 
cabinet be switched off, until disks have been logically powered off with PO. Failure to observe this practice 
might cause disk problems at a later date. 


Format: 


PO disk peripheral 


Examples: 


PO DKA (disk cartridge) 
PO DMB (mini disk) 
PO DFA (fixed disk) 


Output messages: 


ESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


disk peripheral Ok Disk was legically It 1S row permissitle 
or powerec off. to physically cower off 

isk peripheral enc remove the disk 

POWERED OFF from tre disk orive. 


disk peripheral Disk was physically Check cisk for possible 
REMOVED wITHOUT PO off before being corrupted cata before 

: locicatly power- re"uSseé. 

ec off. 


PO disk cericheral Specified cisk Feincut. 
INVALID peritpherat is 
nonexistart. 


Cex? PO DKh) 


PO disk peripheral Specifieo cisk is 
NOT CN SYSTEM. not currently on 
Line. 


Feinput. 


CANNOT POWER OFF Attempt has been made Atlow frogram to 
SYSTEM. MIX NOT to PC the system disk co te Ena of Job 
EMPTY. while a program is (E0J)J>» then reinput. 
or processing. | 

PO disk peripheral 

INVALID 
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If an attempt to Power Off a disk is made while files on that disk are in use, the OL message for the disk 
is printed. No further program will be allowed to open files on the disk and when all files in use have been 
closed, the disk will be logically powered off. If the disk is in use, it will not be powered off immediately after 
giving the PO command though it will print “disk peripheral PO’ED X FILES OPEN”, for all disks. 


If a disk is removed without being logically powered off, any program using files on that disk will eventually 
terminate with an error condition aSiCanne hardware failure. 


A PO’d user disk may be made ready again by the RY command or by physically powering the unit off and 
on. . 
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PR (Assign Program Priority) 


This intrinsic allows the operator to alter the priority of a program by moving it to the highest priority position 
in the class specified. 


Priority ““A”’ is low or normal priority, used for regular work. Within this class, programs which perform more 
physical I/O operations are given precedence. 


Priority “B” is medium priority, used for utilities or programs which may be expected to do emergency work. 
The priority within this class is reverse historical: that is, a program of this priority placed in the mix will take 
precedence over previous programs of the same priority. 


Priority “‘C” is high priority, used for data communications programs that are transaction-driven. These are 


normally dormant, awaiting a transaction, but when required to process a transaction they take high priority 
to minimize response times. Within this class, programs which do more physical I/O are given precedence. 


Format: 


PR mix-number / program-name 


ODD 


Example: 


To change the priority of mix-number 3 (program REP506) to B: 
PR 03/REP506 B 


Output messages: | 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


mix-rnumber/erogram- Input accepted 
name PR IS 
priority 


mixenumber/program= Mix“number and Check with MX 
name PR INVALID program*name do propeér inout » 
not match rewenter 
or 
priority vatue 
incorrect 
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RY (Ready a Peripheral) 


This intrinsic is used to “ready” a peripheral so the MCP can use it as a resource. When warmstarting, the 
system will automatically ready all peripherals on the system that are poweee on. RY may also be used to 


Ready a previousy PO’d user disk. 


Format: 
RY peripheral 
Examples: 
To ready a self-scan: | 
RY SSA 


To ready a line printer: 
RY LPA 


Output messages: 


MESSAGE. POSSIBLE CAUSES 


RY peripheral Attempt was mace to 
INVALID Reedy a non"extstant 
: peripheral (Cthat is» 
RY LLP); 
Attempt was made to 
Feady a device alreacy 
"reacy™ 


RY cerioheral NOT Attempt was mace tc 

ON SYSTEM ready a peripheral 
on-line to the. 
Computer. . 
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SUGGESTED ACTION 


Check input Creinput 
1f necessary) 


Check input Creiroprt 
if nécéssary). 


SF (Substitute Disk File) 


This intrinsic allows the operator to direct a program to a particular disk file if it is waiting on a ““NO FILE”, 
“NO PACK”, “DUPLICATE FILE”, or “BAD FILE NAME” condition. 


This command causes temporary modification of the program’s file parameter block. The modification remains 
in effect for the current execution only, or until it is remodified by the program during the current execution. 


The command can only be used when the program is suspended waiting on one of the above conditions. It 
is not possible to anticipate the program’s requirements and modify the file parameter block in advance. 


disk- 
SF mix-number | / program-name sc a file-name 


file-name 


Format: 


Examples: 


Program AP10 (mix number 01) requests a disk file called APD2T on disk APD. To direct the program to 
use file APD2S on the same disk: | 
01/AP10 <10> WAITING APD/APD2T DK NO FILE 


SF 01/AP10 APD2S 


(the first line is the MCP output message; the second is the input SF message in response to the ““NO FILE” 
condition). | 


To direct the same program to use file APD2T on disk APD1: 
SF 01/AP10 APD1/ 


or 
SF 01 APD1/ 


To direct the same program to use file APTEMP on disk ARTD: 
SF 01 ARTD/APTEMP 


Output message: 


POSSI@LE CAUSE SUGGESTED ACTION. 


mixerumber / Program 1S not Check with MX and 
orogram=name waiting on 4a “no remente€re 
SF INVALID file” or other 

conditions or 

mix-number and 

pregranm"nam@e 

do not corresponc-. 
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ST (Temporarily Suspend a Running Program) 
This intrinsic places a temporary halt on a program that is running. The program still appears in the mix. @ 
The data needed to restart the program exactly where it stopped is transferred from memory and stored on 
disk. The memory that was being used by the “stopped” program is now made available to the MCP for other 
use. The GO command must be used to restart the program. | 


Format: 


ST mix-number | / program-name 


Examples: 


To stop the program whose mix-number is 3: 
ST 3 


To stop the program PRO20: 
ST 3/PR020 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


mix"“number/program ST successful 
name STOPPED 


mix-number/progr am Program has already Check with MX for status 
name INVALIC ~ been stopped cf procram;s Creinput if 
or necesséry). 
prearam 1S not ir 
the mixe 
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SV (Save Peripheral) 


This intrinsic allows the operator to “logically” power off any input/output device (except disks, see PO intrin- 
sic) in order to prevent their use by any program. 


“Tape peripherals” include magnetic tape (MT) and cassette tape (CT). 


‘Printer peripherals” include line printer (LP) and serial printer (SP). 


Format: 
tape peripheral 
printer peripheral 
SV self-scan peripheral 
card-reader peripheral 
card-punch peripheral 
Examples 
SV LPA 
SV SSA 


It is possible to “save” a device that is being used by a program. This will allow the program presently as- 
signed to this device to continue using it, but will prevent any subsequent programs from using the device. For 
example: 


SV LPA 
LPA SAVED IN USE BY 06/PR060 


A “saved” device may be made “ready” again with the RY command or by physically powering the unit off 
and on. 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


periftheratl OK SV success ful 


SV ceripheral Attempt was made to Feingut Cif necessary 
INVALID Save a disk perip- Lsinc correct fperic¢-~ 
herat reral. 
or 
device has alreacy 
been sayed. 


SV ceripherat Specified ceripheral Check input? reinput 
NOT GN SYSTE®M is not onwlLire tec . ¥f necessary. | 
the computer. 


ceripherat PCWER- SV successful. 
EQ OFF 
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SECTION 4 
CMS-COMMON UTILITIES 


INTRODUCTION 


This section describes all standard CMS utilities that form part of a CMS system software release. The applica- 
bility of any utility depends on the type of hardware available. For example, utilities requiring console files can- 


not be executed on machines without a console: as an example, CREATE, AMEND and UPDATE cannot be 
run on a B 1800. 


Table 4-1 gives a list of all required peripherals for each utility. In this table, required peripherals are denoted 
by the letter “R’’, and optional peripherals by the letter ““O’’. One asterisk (‘‘*”?) indicates that out of all the 
options, at least one is required. In particular, those utilities requiring a line printer may use a console printer 
by default if the line printer is not present on the system. Two asterisks (‘‘##”) indicate that out of all the op- 
tions, at least two are required. , 


All the utilities that use initiating message information provide a “star-file” facility. This permits the informa- 
tion to be provided in a disk file instead of from operator SPO input. The entire message, after the name of 
the utility, may be replaced by an asterisk followed by the disk file name. The format is 


| disk-name / file-name 


the input could be 
RM * M101A/RMFILE 


where RMFILE is a disk file on disk M101A containing one record with the contents 
REP200, REP562, RQ=, RCOPY 


For all utilities except the compile utility (CO, see section 5), star-files may contain a maximum of five 
records, and the record-size must be 80 characters. The information should be padded to the right of each record 
with spaces. No nested star-files are allowed: that is, the information in a star-file may not contain a call on 
another star-file. If the specified file cannot be found, a “filename NOT FOUND” message is displayed by 
the utility. 


SYS-SUPERUTL 


This system utility provides the following functions: 
CH —- change the name of a file or group of files 
KX —- interrogate disk space 
PD - interrogate disk directory 
RM - remove a file or group of files 
IR — initiate recall of SPO log messages 
LB - look back in SPO log 


LF —- look forward in SPO log 


It will execute automatically if the program file is on the systems disk when one of these functions are re- 
quired. This program is also automatically executed at warmstart time and co-ordinates logging functions at that 
time. 
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The utility has some features which can cause the operator confusion. The utility will not appear in the re- 
sponse to the MX command unless it is actually performing one of its functions, when it will appear as 12/ 
PD or 12/CH etc., according to the function which it is currently performing. If an attempt is made to execute 
one of the SYS-SUPERUTL functons when it is already busy then a response of <MIX FULL> will be re- 
turned. | : | | 


Table 4-1. Peripherals Required By CMS-Common Utilities 


con? 
sole Idcisk 


card jpaper 
punch {tape IC MD 


Utility 


CHECKADUMP 
CHECK .DISK 


moon 0100 mo Dw. 


AmA DAMA oOomDmrDmA nr VvVIwmA yD AD 


LOGGING 


When the system is warmstarted the SYS-SUPERUTL utility will be initiated and SYS-LOG files will be cre- 
ated. The information about the number and size of log-files is stored in a file called “SYSCONFIG” (see CON- 
FIGURER). Then the MCP will initiate a function of SYS-SUPERUTL, which will start up the ‘TL” utility, 
and the transfer of log-files to a “SYS-LOG-HOLD” file will begin. When all the log-files are transferred and 
TL goes-to End of Job, SYS-SUPERUTL will remove the old SYS-LOG files and create new SYS-LOG files. 


During a session all the console input/output messages that normally appear on the SPO are stored in SYS- 
LOG files SYS-LOG-01 through SYS-LOG-nn, where “nn” is 03 to 16 (see CONFIGURER). When one log- 
file is full the messages will be directed to the next log-file. When all the log-files are full the logging will be 
directed to the first file again. This will overwrite the information held in the SYS-LOG-01 file unless the utility 
“TL” is begun beforehand, which will transfer all the transferable’ log-files and keep them in the “TRANS- 
FERRED” state (see TL). 


The system will automatically transfer all log-files only at warmstart time. 


COMMON UTILITY OUTPUT MESSAGES: 
POSSIBLE CAUSES 


SUGGESTED ACTION 


INVALID CHARACTER Disk rame or file name Check input ard 
IN IDENTIFIER contains cCharacter(s) re“irput if necs 
not permitted by the essary. 
Systeme Valic charac” 
ters ares AwZ» O7G>» 
e (dot)» = (dash). 


ILLEGAL PARAMETER Typing error. Check Input. After 

LIST 7 words “ILLEGAL 
PARAMETERS LIST” 
system will disolay 
portion of input 
TeSSagqe that contains 

phe eed — . error. 


filename NOT FOUND Specified file name Check input and reenter 
or 1s not on disk. 1f necessary; check 
filename NOT ON | for correct cisk; 

IL INE supotlty specified file 
(COPY file from tack- 
uc mécium or create 

Mo ise eat Sosa ee aunt A file). 


NO SPECIFICATIONS Input message is Check input and 
GIVEN incomplete. rewerte€re 


DISK disk*name specified cisk is Check input arg 

NOT GPENED NAOT ON not online to reenter if necessary» 

LINE computer. Check for correct disk3 
ra | Ready Cisk; 


DISK disk=-name 
NOT AVAILABLE 
or 
DISK disk*name 

FOR xD NOT 
AVAILABLE 
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ADD (Add Files From Library Tape to Disk) 


This function, a part of the utility LD, allows the operator to copy files. from a library tape to a disk. © 


Format: 


LD | ADD FROM library-tape-name 


TO disk-name 


file-name or | | F 
group-name |-< BOTHS— 


If the <BOTH> option is used immediately after a request to add a keyfile, the data file will also be copied, 
provided it does not precede the keyfile on the library tape. The keyfile will then refer to the disk which now 
holds the data file (rather than the disk from which the data file was dumped to the library tape). 


A file is copied only if no other files on the specified disk have the same name. 


_ Examples: 


To copy all files from ARTAPE to the system disk: 
ADD FROM ARTAPE= 


To copy a file called PRFILE from PRTAPE to a disk called PRBU: 


ADD FROM PRTAPE TO PRBU PRFILE 


To copy files called GL300 and GL200 from GLTAPE to the system disk: 
LD ADD FROM GLTAPE GL300 GL200 


To copy a keyfile called PR240K and its data file from a tape called PRTAPE to a system disk= 
ADD FROM PRTAPE PR240K <BOTH> 


Since “ADD” is a part of the utility LD, “LD” 1s actually what will appear 1 in a mix message. To discontinue 
the ADD function, “DS mix-number/LD” must be used. 


Output messages: 


filename LOADED 


Library*tape"name 
NOT A RECOGNIZED 
DUMP TAPE 


NO FILES IN THE 
FAMILY group"name 
ON TAPE Library=- 
tape-name FOR 

ADD | 


POSSIBLE CAUSES 
ADC successful 


Specified tape does 
not have a valid CMS 
tahels or has not 
been created by the 
to utility Cfor 
example? tape 1s a 
COPY tape). 


Specified group was 
not found cn library 
tape - 7 


SUGGESTED ACTION 


Frovide correct tafe 
énd retrys or OS LC 
ctility. 


Check tnput and re- 
input if necessary; 
Check’ for correct 
library-tape. 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


NO FILE filecname Specified file was not Check input and re*input 
ON TAPE Library=tape-= found on Library if necessary>s check 
name FOR AOC tape. for correct Library 

fLacee 


file"name LOAC/ End of File reached Try tape on different 
DUMP DISCREPANCY before expectec. Nisk crive in case the 
Fite Header may te crive is at fault. 
corrupted. Possitly 

due to mis*reading 

of tape. 


NO FILES TO LOAD files were founds Check Input and re- 
on this tape to cony input if necessary, 


to disk. Check for correct tape. 


filename NOT LOADED File not copied as a Normalty remove with 
- ALREADY ON JISK. file with the same KM the duplicate file 
ALTHOUGH WITH name already exists and re-attempt the 
DIFFERENT ATTRI8@- on disk. If the Zz ADC. 

UTES. fites aiffer in record, 

block» and file sizes» 

the "DIFFERENT ATTRIa- 

UTES™ message prints. 


file-name OATA FILE Nata file for given 
NOT FOUND ON TAPE keyfile does not 
FOR LOAD. follow on tafe. Data 
file cannot be coptec. 
Keyfile is Copiec. 


Note: Refer to “(Common Utility Output Messages” for additional aid. 
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AMEND (Disk File Amending) | 


This utility is used to modify records within an existing data on source file. The “CREATE” and “UPDATE” © 
utilities use many similar features. 


Format: 


AMEND | disk-name/ 


Input may be either alphanumeric (A) or hexadecimal (N). (See “CREATE” for details). The default is “ Ar’. 


file-name 


The “number” option may be used to set “tab” positions for character input (see “CREATE” for details). 


The utility operates in two modes: “Record Modify” (PK2) and ‘Record Select” (PK3). 


PK1 is used to select the next sequential record in the file to be printed. The use of PK1 terminates ““Record 
Modify” and “Record Select” modes, therefore a re- “selection of mode must be made before continuing. & 


If PK3 (Record Select mode) is used, the required record is identified by logical record number using this 


format: 
| RECORD number 


The “number” may take any value from 1 to the number of records in the file. 


PK2 is used to make corrections to existing records. This PK operates as PK2 in CREATE utility (see CRE- 
ATE for details). 


Example: 


To amend a source file called MYFILE, record size 40 bytes, tab set at 5, 10, 15, 20: 
AMEND MYFILE 5 10 15 20 


First select a record by pressing PK3, and then enter ‘20” for logical record 20 in MYFILE. Utility selects 
and prints the contents of record 20. 


20 ABCDEFGHIJKLMNOPORST 


To replace characters, press PK2 and type the replacement 


D : ZZZZ : OCK1 | | _ 


resulting in “20 ABCDZZZZIJKLMNOPORST” 


4—6 


Or if insertion of characters is desired, type the characters to be inserted into the record: 
Z: XXXXXX : OCK2. 


resulting in “20 ABCDZXXXXXXZZZOPORST” 

NOTE: the insertion from character six to eleven will result in the shifting of characters “ZZZIJKLMN” from 
byte position 12 to the boundary of the next tab position, which is 15. Therefore only 3 characters “ZZZ”’ are 
shifted from 12 to 14 and “IJKLMN” are lost. The text from the next tab position 15 onwards is not affected. 
Output messages: 


Refer to the section on the “CREATE” utility for output messages. 
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CH (Change File Name) 
(a function of SYS-SUPERUTL) 
This utility allows the operator to change the name of a file or group of files on disk. The <DATA> option 


allows the data file of an indexed pair to be changed, and it will also cause the keyfile to refer to the new 
data file name (the keyfile name does not change). 


Format: 
/ file-name or | | | file-na 
CH | disk-name / group-name < DATA> TO. SroUE atic: 
Examples: 


To change the name of a single file: 
CH BPS320D/DCSTSK36K TO DCSTSK 
CH DCSTSK TO INDISK3TSK 


To change a group of files: | 
_ CH BPS320A/AR= TO BP= 
CH PRB= TO PR= 


To change several different files or groups of files: 
CH DCSTSK TO INDISK3TSK, BPS320A/AR= TO BP= 


To change the name of the data file of an indexed pair: 
CH AR200K <DATA> TO AR200BU 


Note: if a change of group file name is specified. with the <DATA> option then the data file should appear 
in the directory after the keyfile. If this is not the case then the name of the data file is changed first, and 
when the attempt to change the key file name is made, a “data file-name NOT FOUND” message will be dis- 
played. This will not occur when changing the name of a single indexed file. 


Output messages: 


MESSAGE POSSIPLE CAUSES SUGGESTED ACTION 

"file name” CHANGED 190 Fite nane success- None. 

"file name” | fully changed. 

"file name” NOT Specified file Check Input or (Cres 

CHANGED = NOT FOUNC name is not on input 1f necessary) » 
disk. | Check for correct 


Cisk. 


NO FILES FOUND FOR Specified group Check input Cre-input 
KANGING IN THE name is not on df necessary) 

FAMILY. “group=name” disk. Check for correct 

| | cisk. 
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MESSAGE POSSIBLE CAUGES SUGGESTED ACTION 


"file nase” NOT Fite’s name Cannot bait until file is 
HANGED IN USE be changed because ro toncer In use» 
it is currently then reé*input.- 
being used by system. 
*"name”™ FILE IDENT™ Attemot has been mace Re~irpute 
IFIEF TOO LONG to change a file name 


to more than 12 
characters in tlerctft. 


"file name" NOT Attemot has been made Rewirptuit. 
CHANGED = ILLEGAL to change the name of 
REQUEST a file to “SYSMEM” 

Ca name reserved for 

system use) or att 

SNaces. 


"file name” NOT Attempt has been made Re-irput.e 
CHANGED - *file namre”™ to duplicate the name 
ALREADY ON OISK of a file atready on 

diSke 


KEYFILE "file name" Successful completior 
NOW POINTS TO DATA of data file name 
FILE “file name”. change. 
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CHECKADUMP (Compare Library Tape with Disk) 


__ This utility allows the operator to compare information in files on a library tape with corresponding files on 
disk. It is used to verify that a library tape is correct after files have been DUMPed or |UNLOADed, or that 


disk files are correct after files have been ADDed or LOADed. Specified tape is processed sequentially, file 
by file, and the disk is searched for corresponding files. The utility will notify the operator on up to four errors 
in a given file. If there are more than four errors, it will ignore the rest of that file, and proceed to the next 
file on tape. | ! 


Format: 
CHECKADUMP library-tape-name | WITH disk-name _— 


Examples: 


To compare files on the tape called PRTAPE with the corresponding files on the System disk: 
CHECKADUMP PRTAPE 


To compare files on the tape called ARTAPE with the corresponding files on a disk called ARDISK2: 
CHECKADUMP ARTAPE WITH ARDISK2 


Output messages: 


MESSAGE | POSSIBLE CAUSES 


SUGGESTED AC TIGN 


Library-tape-name First record of tare 
NOT A RECOGNIZED not recognized by 
DUMP TAPE CHECKADUMP. Tare 
may not have heer 
created by LD 
utility. | 


None. Utitity ends. 


library-tapecname More or fewer entries None. (See CMS MCP 
INVALIC DIRECTORY in directory on tape Reference Manual 
ON TAPE than specified ir the for é@dcitional in- 
first record of tape. formation on tade 

| formats. 


COMPARISON ERROR Reader in tody of tarce 
ON librarv-tape- 1S not identical to 
name ON OISK FILE respective heacer in 
HEADERS. disk directory. The 
— error count for the 
file ¥s increased ty 1. 


Fecreate dump 


COMPARISON ERROR Corresponding cisk Recreate dump 
CN filetname FILE NOT file Cannot be founc 


FOUND FOR CHECK. for file or tare. 


tape. 
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COMPARISON ERROR ON Corresponding aisk 
filename FILE NOT file cannot be read 
AVAILABLE FOR for this file on 

CHECK tape. 


Recreate dump tape. 


COMPARISON ERROR ON Discrepancy between tape. 
file*name CAROUND disk file and tape 
RECORD number) : file. Record numter 
in vacinity of error 
in file is printec,s 
if possible. One is 
added to error Count 
for this file. 


Recreate 


COMPARISON ERRGR ON Difference tn lenath Recreate dump tafe. 
filename AROUND of tape ano disk filese- 

END OF FILE One 15 added to error 

count for that file. 


COMPARISON ERROR Difference in sizes 
ON filename DIFFER- of disk and tape 
ING FILE SIZES files. 


Recreate 


COMPARISON ERROR ON Difference in file Recreate dunp tape. 
filename CIFFERING tyoes of files being 
FILE TYPES como arede 


COMPARISON ERROR ON Difference in recorc Recreate dump tape. 
file-name DIFFERING sizes of the files 

RECORD SIZES being comoarede 

COMPARISON ERROR CN Difference tn block Recreate dump tape. 
filename CIFFERING sizes of files hbeina 

BLOCK SIZES compared. 


NO DISCREPANCIES CHECKADUMP success” 
BETWEEN OUMP TAPE ful. 
library-tape"name 
AND OISK disk=*name. 


DISCREPANCIES FOUNC Discrepancy discover” 
BETWEEN DUMP TAPE ed between disk file 
library-tape"name and tape file. 

AND DISK disk=«name. 


Recreate dump tape. 


NOTE: Refer to “Common Utility Output Messages” for additional messages. 
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-CHECK.DISK (Check all Sectors of a Disk) 


This utility reads every sector on a specified disk, and reports on any parity errors encountered. 


Format: 


CHECK.DISK | disk-name | 


If no disk is specified, the system disk will be checked. — 


Example: 


To read and report any parity errors from sectors of a disk ARBK: 
CHECK.DISK ARBK a 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ERROR NOTIFIED ON Normal output messace. 
READING SECTOR yn Utility continues. | 


CHECK.DISK ON Normal EOJ messaces. 
disk-name COMPLETED 
“ERRORS NOTIFIED 
or 
CHECK.OISK ON 
disk-name COMPLE T= 
ED-NO ERRCR 


Note: refer to “Common Utility Output Messages” for additional messages. | 
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COMPARE (Compare Files) 


This utility compares corresponding records in two files, or in pairs of files within two groups. A realignment 
feature is also available as an aid to detecting missing records. 


Format: 


| | file-name or 
COMPARE disk-name / group-name WITH 
file-name or 
disk-name / group-name | R 


To compare file PQ60R on the system disk with file PQ60RS on disk PRB3: 
COMPARE PQ60R WITH PRB3/PQ60RS 


Examples: 


To compare the groups of files beginning with AR and the files A27Q on disk ARBK1 and ARBK2: 
COMPARE ARBK1/AR= WITH ARBK2/AR=, | 
ARBK1/A270 WITH ARBK2/A27Q 


To compare the file IV20F on the system disk with the file of the same name on disk 132, with realignment: 
COMPARE IV20F WITH 132/IV20F R | 


If corresponding records are different, the following is printed on a line printer file (or console printer if the 
line printer is not available). 


DIFFERENCE DETECTED AT BYTE @nnnn@ 


where n is the number of the byte in the record, starting from 0. The two records are then printed, using 
more than one line if necessary,with the following format: 


byte-offset 
32-byte groups in hexadecimal 
32-byte groups in ASCII 


(A null character (00) in hex is represented by “..”, and a non-printable character in ASCII represented by 
a blank). 


Comparison of groups of files works as in the following example: 
Assume DISK1 contains the files A, B, C, D, AB, AC, ABC, BC. 


Assume DISK2 contains the files A, B, C, D, AB, AC, ABC, BC, BD, EF. 


Then 
COMPARE DISK1/= WITH DISK2/= compares all files on DISK1 with the corresponding files on 
DISK2. 

But 
COMPARE DISK2/= WITH DISK1/= compares files on DISK2 with the corresponding files on 
_DISK1, and will fail to find DISK1/BD and DISK1/EF. 

Similarly, 


COMPARE DISK1/A= WITH DISK2/A= compares files A, AB, AC and ABC on DISK1 with the 
corresponding files A, AB, AC and ABC on DISK1 with the corresponding files on DISK2. 
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Also, | : 
COMPARE DISK1/A= WITH DISK2/AB= compares the following pair of files: 

DISK1/A with DISK2/AB, : 

DISK1/AB with DISK2/ABB, (not found) 

DISK1/AC with DISK2/ABC, 

DISK1/ABC with DISK2/ABBC (not found) 


The realignment option works in the following manner: 


If three consecutive records fail to compare then an attempt is made to compare the third record of the second 
file with the next two records of the first file. | 


If all these five comparisons fail then an attempt is made to compare the fifth record of the first file with 
the fourth, fifth, sixth and seventh records from the second file. 


If this comparison fails, then the comparison is terminated with an appropriate message (see later). 


If a correct comparison occurs at any stage, then the compared records are used as synchronization for restart- 
ing normal comparisons. | 


For example, consider FILE1 containing 10 records A, B, C, D, E, F, G, H, I and J, and FILE2 containing 
twelve records K, L, M, N, O, P, Q, R, S, T, U, and V. | 


The utility compares record A with record K, then B with L, then C with M. If all these comparisons fail, 
then if realignment is specified record M is compared with records D and E. If this also fails, record E is com- 
pared with records N, O, P and Q. If none of these compare, the comparison is terminated. 


Note that if there is a missing record in one file, and realignment is NOT specified, a comparison error will 
arise on every succeeding record until end-of-job. | | | 


Additional Capabilities 


Further features in this utility are summarized in the railroad chart given in Figure 4-1, which gives the com- 
plete input specifications. 


Non-disk devices: 


Files on devices other than disk may be compared by following the file name by one of the following key- 
words: | 


CRD - any 80-column or 96-column card device 

PTR - any paper tape input device 

MTP —- any magnetic tape or cassette device 

DSK - any disk device (the default; this keyword is for — 
documentation only) 7 | 
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< comp-spec > 


_L < disk-id >/ Dt ces 


— COMPARE 


<comp-spec > is defined as : | 
< mfid-spec- 1 >— WITH —< mfid-spec-2 > 


<gid-spec-1 >— WITH — < gid-spec-2 > 


< mfid-spec> is defined as : 


CRD 
MTP 


PRT 


<mfid>— / < file-id > DSK — <nr> <nb> 


- gid-spec > is defined as : 


< disk-id > —/— < group-id > DSK <nr <nb> 


Figure 4—1. Railroad Chart for Compare Utility 
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Examples: 


. To compare records on a cassette file ARDUMP/FILE020 with a file AAR5S78Q0Q on the disk WDSK: 
COMPARE ARDUMP/FILE020 MTP WITH WDSK/AR5780Q 


(note that the two-part name’ is valid for multi-file tapes or cassettes, refer to section 2 for naming conven- 
tions). | 


To compare two card files DAT1 and DAT?: 
COMPARE DAT1 CRD WITH DAT2 CRD 


Record and block sizes: 


The record size (and the number of records per block) may be specified after the file name and device key- 
word if applicable. | 


Examples: 


To compare a system disk file CU265 with a magnetic tape file TPF, treating data blocks on the tape as 80- 
byte records blocked 9 records to a block: 


COMPARE CU265 DSK WITH TPF MTP 80 9 


To compare a system disk file SCRO1 containing 90-byte records with a system disk file SCRO2 containing 
180-byte records, but reblocking the second file as 90-byte records: 


COMPARE SCRO1 WITH SCRO2 90 2 


Note that if the records to be compared are of different lengths, and reblocking is not specified, then only 
the number of characters in the shorter record are compared. 


Limitations: 

The maximum record size is 1024 bytes. If a file exceeds this record size, it may be compared by reblocking. 
For example, a file with record size of 1200 can be compared by reblocking as 600 bytes blocked 2, or as 300 
bytes blocked 4. The higher the blocking factor, the slower will be the comparison. (If the record size is a prime 
number P, it can be reblocked as 1-byte records blocked P). 


The use of a star-file terminates the list of pairs of files to be compared. For example, 
COMPARE A= WITH DK2/A=, X= WITH DK2/X=, . 
STFILE, B= WITH DK2/B= 


will compare A=, X= and all files mentioned in the file STFILE, but will ignore the comparisons of B=. 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


CANNOT OPEN FILE Usually» file 3s not None if grouo compare 
filename | present or in usé by 15 doner or check inprt. 
another program Also check 4X. 


END OF FILE filename End of one file is 
BEFORE filename - detected before the 
n ERRORS end of the other fite 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION | 


filename WITH Normal ending message None. 
filename COMPARED - if both files ére 
n ERRORS Same S12Ze. 
ILLEGAL SYNTAX Initial Input mris= Check input and 
FOR ITEM input 3 typed- re"enter. 
CANNCT REALIGN Ending meSSace if None. 
filenane WITH realiaqnment has teen 
filename7n ERRORS specified but has 
faited.e 
INCOMPATIRLE A file is specified Feinput Correct 
FILESPECS input to be compared with mesSéae€. 


a crouc of fites» or 
vice versa. 


ITEM TOO LONG input Input message creater Divice input irto 
than 256 characters. separate parts» anc 
rewerter. 


DIFFERENCE DETECTED See example earlier See exembple eartier 
AT &8YTE annnna@ 


CANNOT READ RECORD Parity error on Use tackup cory of 
n OF filenane disk fite. file ccncernecs if 
possible. 


2007258 4-17 


COPY (File Copy) 


This utility allows the operator to copy files from one medium to another. © 


Format: 


7 file-name or 
COPY disk-name / group-name 


< KEY > 
or | 
<BOTH> 


TO 


: | | file-name or 
disk-name / group-name 


If as a result of the copying a file a duplicate filename would be created, the original file on the destination 
disk is removed automatically. | | 


If the file being copied is a keyfile and the <KEY> option is used, the keyfile is copied and the new keyfile 
refers to the original data file. | 


If the file being copied is a keyfile and the <BOTH> option is used, the keyfile and the corresponding data 
file are copied. The data file is given the keyfile name with the letters, “QQ” appended. The new keyfile is 
made to refer to the new data file name. ea 


If the file being copied is a keyfile and neither <KEY> nor <BOTH> options are used, only the correspond- 
ing data file is copied. The records of the new data file are created in keyfile order. 


Examples: 


To copy a file called AR200 from the system disk to a disk called ARBU: 
COPY AR200 TO ARBU/AR200 


To copy files called AR200 and AR300 from the system disk to a disk called ARBU: 
COPY AR200 TO ARBU/AR200 AR300 TO ARBU/AR300. 


To copy a file called APTASK from the system disk to APBU, changing its name to APTASKB: 
COPY APTASK TO APBU/APTASKB. | 


To copy all files beginning with letters “PR” from disk PR2 TO disk called PRBU: 
COPY PR2/PR= TO PRBU/PR= : 


Copying Keyfiles 
Assume there is a keyfile called PR200K which refers to a data file called PR200. 


The statement 


COPY PR200 <KEY> TO PRB/PR200K will create a new keyfile PR200K on disk called PRB which 
references the original data file, PR200, on the system disk. 


The statement | 


COPY PR200K <BOTH> TO PRB/PR200K will create a new keyfile and data file on disk called 
PRB. The name of the new data file will be PRB/PR200KQO and the keyfile (PRB/PR200K) will refer 
to this new data file. ; | 


The statement 


COPY PR200K TO PRB/PR200K will create a new datafile PR200K on the disk PRB. No new keyfile 
will be created but the records in the new data file will be created in key order according to the keyfile. 
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Additional Capabilities 


Further features in this utility are summarized in the railroad chart given in Figure 4-2, which gives the com- 


plete input specifications. 


* < file-name > 


< group-copy > 


— COPY 


< d-file > 


TO 


<s-file > 


< group-copy > is defined as : 


oneness < group-name-1> TO ——= < group-name-2> —> 


<s-file> is defined as : 


CRD 
1 MTP 
PTP 
<BOTH> 
1 
<KEY> i < r-spec > 
—< file-name 
1 RECORD <nr> 
1 BLOCK ——————————_ < nb> 
1 TAPE.MARKS ———— <nt> 
1 NO.LABEL 


Figure 42, Railroad Chart for Copy Utility (Sheet 1 of 2) 
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<d-file > is defined as: 


< file-name > 


< r-spec> is defined as : 


RECORD fas 


BLOCK ———_«< | nb 
FILESIZE —<nf> 
SINGLEAREA 

CRUNCH 


EXTENDING 


CRD 
MTP 


PTP 


< r-count > 


< record-key > 


= <record-key > 


_ Figure 4—2. Railroad Chart for Copy Utility (Sheet 2 of 2) 
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Non-disk devices 


Files may be copied to and from media other than disks. Abbreviation for the valid devices are as follows: 
MTP — magnetic tape or cassette 
CRD - punched card 
PTP — paper tape 


Examples: 


To copy a cardfile called PRFILE to a disk called PRBU: 
COPY PRFILE CRD TO PRBU/PRFILE 


To copy a disk file called PR300 to a single-file magnetic tape: 
COPY PR300 TO PRTAPE MTP 


NOTE 
This tape is in “COPY” tape format, not “LOAD/DUMP” format. To access this 
tape file again it will have to be placed on appropriate device by “COPY” utility, 
not °’ LOAD/DUMP”’. 


To copy a cardfile called PRFILE to paper tape: 
COPY PRFILE CRD TO PTFILE PTP 


Note: Paper tapes are always “unlabelled”, and when accessing it, MCP will issue appropriate message requir- 
ing an ‘“‘AD” intrinsic response from operator. See “AD” intrinsic. 


Unlabelled tapes 

Input tapes having no CMS labels (“unlabelled”’ tapes) may be accessed by the COPY utility. 

The NO.LABEL option allows the copying of unlabelled files. Upon recognizing an unlabelled file, the MCP 
will print a “DEVICE REQUIRED” message. The operator must then respond with an appropriate “AD” in- 
put message (see ‘““AD”’’) to identify the unlabelled file. 

The end of file recognition for unlabelled files is determined by tapemark count. The TAPE.MARKS option 
allows the operator to specify the total number of tapemarks which will indicate end of file to the utility when 
copying an unlabelled file. The default value is 2. Each tape mark which is encountered will contribute to this 
total. Therefore, a standard labelled CMS file will be copied up to, but excluding, the trailing label if NO.L- 
ABEL is specified by itself.(The standard CMS labelled tape format is “label, tape mark, data, tape mark, la- 
bel”, see CMS MCP manual). The operator must be aware of the format of any file which is to be copied 
when using the NO.LABEL option. 

If the RECORD size is not 180 bytes, refer to the section on Record/Block modifications. 
Example: 


To create a disk file called EMPL from first file of a magnetic tape with non-standard label (the format being: 
LABEL, TAPEMARK, DATA, TAPEMARK): 


COPY TP MTP NO.LABEL TAPEMARKS 2 TO EMPL 


Note: MCP will issue a message asking for unlabelled tape TP. Operator must respond with “AD” input. 
Additionally, the first record of file EMPL will contain a copy of the non-standard label. 


Record and block sizes 


Record and/or Block sizes may be modified for all file types, input and output. 
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The number of bytes in the record or block is specified using the corresponding “‘numbers”’. The record and 
block sizes of input disk files are always taken from the file itself (Disk File Header). Record and block sizes 
of non-disk input files are determined as follows: 


Record Size: 
If RECORD is specified, ‘“‘number’’ becomes the new record size. 


If RECORD is not specified record size defaults (see below). 
Block size: 


If BLOCK is specified, “number” becomes the new block size. 
If no BLOCK specified, but RECORD IS specified, record size becomes new BLOCK size. 


If neither BLOCK nor RECORD is specified, Block Size defaults (see below). 
Default Values: 


Output disk = same as input disk. 

Input labelled tape/cassette = from tape label 
Input unlabelled tape/cassette = 180 bytes 
Cards = 80 or 96 bytes, depending on device. 


Example 


To copy an 80-column card file labelled PROGSRC to a disk file called PROGSRC on a user disk “USR”, 
and make the record size and block size of the disk file 80 bytes and 720 bytes respectively: 


COPY PROGSRC CRD TO USR/PROGSRC RECORD 80 BLOCK 720. 


To copy a disk file PRBU/PR300 to magnetic tape with large blocks suitable for tape media: 
COPY PRBU/PR300 TO PRTAPE MTP RECORD 180 BLOCK 1800 


File size 
The “FILESIZE attribute” of a disk file may be specified for the output disk file. Note that only assigned 


areas are copied. This feature does not increase disk space at the time of copying, but allows programs ¢o add 
further records if required. At that time extra disk space may be needed. 


Example: 


To copy FILE1 and increase its “FILESIZE” to 1500, replacing the original by the copy: 
COPY FILE] TO FILE1 FILESIZE 1500 


Single area 


The “SINGLEAREA attribute” may be specified for the output disk file. This ensures that the new file will 
occupy a single disk area. | 


Example 


COPY FFLE2 TO FILE2 SINGLEAREA 


Crunching files 


The “CRUNCH attribute” may be specified for the output file. This causes any unused disk space at the 
end of the file to be returned to the system. 


Example: 


COPY PRB/PR200 TO PRB78/PR200 CRUNCH 


WARNING 
A file cannot be “‘uncrunched” once it is crunched. This means it cannot be extend- 
ed. It can only be used for inquiry. This option is therefore useful for storing history 
files. 
Extending disk files 


Records can be added to the end of an existing disk file with the option “EXTENDING” . The existing file 
must have identical attributes to the file being copied. 


Example: 


A data file called DFTUES was created with Tuesday’s data. To add this data to the end of a file called 
DFMON (containing Monday’s data): 


COPY DFTUES TO DFMON EXTENDING 
(Note the size of DFMON must be large enough to contain all required records.) 
Selected file copy 
Selected record numbers from the input file may be copied. 
Example: 


To copy 500 records starting at record #1200 from file FILE1 to file FILE2: 
COPY FILE1 1200 500 TO FILE2 


Note: 


pairs of numbers may be specified within each pair; the first number specifies a relative record number and 
the second specifies number of records to be copied. If an extra number is specified, the last number specifies 
copying from that record to the end of the file. 


Example: 


To copy records 100 to 149, 300 to 499, and 1000 to end of file: 
COPY FILE1 100 50 300 200 1000 TO FILE2 


Selected index file copy 


For indexed files, copying of records can be selected based on content of the key. There are 2 options: the 
number of records can be specified, or an ending key value. 


Examples: 


POR is a keyfile containing personnel records. To copy 15 records from the corresponding data file starting 
from the record with personnel #01786 to a data file, PSNL: 


COPY POR 01786 15 TO PSNL 
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Using same keyfile, to copy all data records from personnel #01786 to _ to data file, PSNL: 
COPY POR 01786 ~ 18000 TO PSNL : @& 


Note: 


The second option is specified by the hyphen in the COPY statement. Note that at least on space is required 
before and after all key values (personnel # in this case). 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


numbers number IN Frror found in pair Check input ara 
file name NOT COPIED of numbers for set” re"erter. 

ected record cory 

optione One record 

number in the pair 

incicates a section 

of the file adcress 

than a orevioustly 

specified sectton.e 

This pair is ignored 


filetname EXHAUSTED Endtof"“file was eén* 
countered while the 
section of the file 
indicated was being 
copiede 


filename TO filename Particular attritute Check input arc 
BAD ATTRIBUTES specifications is rewenter. 

meaningless or tr 

Consistent. The ins 

consistencies will © 

be in relationship 

between output device» 

record size» and 

block sizes or att- 

empt was made to adda 

records to a file 

whose attributes 

differ from those of 

input file. 
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MESSAGE 3 32~- 
FILE IDENTIFIER 
file-name TOG LONG 


filename T" filename 
COPY DISCREPANCY 


filename TOD filename 
COPIED 


filename NOT COPIETL 
ILLEGAL REQUEST 


filename NOT ACCEPT= 
ABLE RECORD SIZE 

OF m IS GREATER THAN 
THE MAXIMUM SPECIF- 
IED FOR THIS RUN 
RESUBMIT 


filename EXtAUSTECL 
DURING RANGE recora* 
key number 
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POSSIBLE CAUSES 

Copy of a group of 
files was requested. 
At least one file> 
nane that was to be 
gererated ty the 
copy would have Ceen 
more than 12 charac: 
ters tong» maximum 
length of file-names 
is 12 characters. 


Endtof*file reached 
before expected. 
Disk File Header may 
be corrupt. 


COPY successtul.- 


Copy of a group of 
files was requested. 
An individual file- 
name of "SYSMEM*® or 
“(spaces)” was to have 
been producecdce "SYS" 
MEM™ Ca file-name 
reserved for system 
use onty) and 
"{snpaces)™ are not 
acceptable filenames. 


Copy has encountered 
a file with 4a record 
s1ze greater thar 
expected. This cén 
happen if a magnetic 
taoe file with a 
record size greater 
then 1024 charécters 
1S submitted to the 
utility without the 
record size heing 
properly snecified 
in the initial input. 


Fndeofefilte encounters 
ed white section of 
fite indicated by 
"recorawkey”™ “nurber” 
is being copied. 


_ SUGGESTED ACTION 


Check input and 
rererter. 


Check Input 
re"erter. 


Check input 
revmerter. 


None 
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filename EXHAUSTED 
DURING RANGE 
"record-key” 
“record=key” 


NO RECORDS FOR 
COPYING FROM 
filename 


INPUT RECORD number 
OUTPLT RECORD number 
PERMANENT ERROR GON 
INPUT FILE 


INPUT RECORD number 
OUTPUT RECORD number 
PERMANENT ERROR 

ON OUTPUT FILE 


INPUT RECORD | 
number OUTPUT 
RECORD number 
OUTPUT FILE TOO 
SMALL 


filename T° file- 
name COPY FAILURE 


NO RECOROCS IN THE 
KEYFILE 


filename NOT FOUND 
FOR EXTENDING 


filename REMOVED 


filename 192 filename 
SELECTION CRITERIA 
IGNORED 
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Specified file 


POSSIBLE CAUSES __ 
No records were 
found ir the rarce 
"record“key” 
"record=key”™. 


contains no records 


for cooying. 


Error encounterec- 


utility cannot 


continue. 


Error ercounterec” 
utility Cannot 
continue. 


Error ercounterec@™ — 
utility cannot 
cortinue. 


COPY unsuccessful irr 
ecoverable error was 
encounterec. 


<POTH> option was 
used. Utility was 
able to access to a 
data file through. 
some failure in the 
keyfite. 


Specified file was 
not fourd. 


COPY successful. If 
any cuplicate files 
are encountered Ly 
COPY they are aut- 
omaticéeltly removed. 


Confirms that select>- 
Ton criteria were. 


specified when copy” 


ing a pair of files» 
anc have been ciscard” 
aa 


_ SUGGESTED ACTION 


Check input and 
remerter. 


Check for Correct 
filerane. 


Do selective copies of. 
the carts of the file 
before and after the taa 
record» as part recovery 


Remove the disk area in 
error with XD utility 
end rerur the COPY 


Fe-irput the COPY with 
suitetle FILESIZE 
option. 


Check input and 
rererter if necessary» 
Check for correct 
mecium» 


BAD ATTRISUTES 
SPECIFIED 


filename TN filename 
EXTENDING FLAG 
IGNORED 
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POSSIBLE CAUSES | 


Inconsistent attrib 
utes were specified 
for tnoput file. 


EXTENDING option was 
jqnored by utlity 
when pair cf files 
was Copied. 


SUGGESTED ACTION 


Check tnput and 
revwerter. 
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CP (Compute) 


: This utility allows simple computations to be made, with the answer displayed in decimal and hexadecimal. @ 
Input may be either decimal or hexadecimal. Hex values must be enclosed in @ symbols. 

The utility may be initiated with a single computation to perform, in which case it will do the calculation 
and terminate. If no calculation is initially provided, the utility issues an ACCEPT to enable the computation 


to be entered. In this case the utility will do the calculation and then issue further ACCEPTS until a null input 
to the ACCEPT is given. | | 


Format: 


CP number number 


+ 
/ 
M 


The numbers accepted are any decimal or hex values in the range 
0 999999999999999|@38D7EA4C67FFF @] 


or the negative equivalent. 

Parentheses are not allowed. The calculation is performed on a strictly left-to-right basis. The operators +, 
—,*,/, and M are for addition, subtraction, multiplication, division and modulus division (the result is the re- 
mainder) respectively. | | : 


Examples: 


To compute the hexadecimal value of the decimal number 12345: 
CP 12345 | 


To compute the value of a complex expression: 
CP 555 *3 + 2-100 #2/5 


(Note: the result of the above is 626, because the calculation is done strictly left-to-right). 


Output messages: 


MESSAGE : POSSIBLE CAUSES SUGGESTED ASTICN 


CP = NUMBER TOO At least one number Re-incut. 
LARGE | | 1s out of range. 


CP : MISSING Two Consecutive Re-input- 
1OPE RAND operators (+> etc) 

have been e€nteredc 

With no number 

betweer- 


CP =: HEX. NO. WITH 
MISSING "™Q” 


CP : INVALID 


OPERATOR 


CP : OVERFLOW 


CP =: DIVISION BY 
ZERO 


2007258 


POSSIBLE CAUSES 


Iitegat symbol; 
or missing Qa 
symbol at front 
or back of a i 
hex value. 


Iltegat symbol; 
or an operator 
(+, etc) has heen 
omitted. 


An intermediate 
value in the com? 
putatior 1s greater 
then the méximum 
value. 


Self explanatory. 


SUGGESTED ACTION 


Re-input. 


Re-irptt. 


Re-irput. 


CREATE (Create Disk File) | 


This utility allows the operator to create or extend data or source disk files. The “AMEND” and “UPDATE” 


utilities use many similar features. 


Format: 


FILESIZE number 
CRUNCH 


CREATE | disk-name / Vy file-name S ! RECORD number | 
: BLOCK number number 
| N- 


or 


CREATE eee disk-name / file-name | 4 ‘ number | 


When creating a new disk file, certain attributes may be specified. 


If the S option is selected, a source file will be created using alphanumeric input. If the A option is used 
a data file will be created using alphanumeric input. The N option creates a data file with hexadecimal (numeric) 
input. If none of these is selected, S is assumed. Alphanumeric input is accepted as typed, but numeric 
(hexadecimal) input requires two characters (0-9, A-F) for each byte of the record. 


The RECORD option allows the operator to specify the number of characters per record of the new file. 
If no record size is specified, a record size of 80 bytes is assumed for source files, and 180 bytes for data files. 


The BLOCK option allows the number of characters per block of a new file to be defined. The defaults are 
as follows: | 


If RECORD size was specified but no BLOCK, BLOCK size will equal RECORD size. 


If neither RECORD nor BLOCK is specified, RECORD size will be 80 bytes for source files and 180 bytes 
for data files; BLOCK size will be 160 bytes for source files, 180 bytes for data files. 


The FILESIZE option allows the maximum number of records likely to be written to the new file. This is 
useful in allocating only as much disk space as required by the file. Once the FILESIZE has been specified _ 
for a file, that file can never be extended beyond that number of records. However, the COPY utility may 
be used for increasing the FILESIZE of an existing file. The default is 2,048 records. 


The CRUNCH option allows the operator to specify that the new file should occupy the minimum area of 
disk, but never be extended. | 


The numbers specified for the “numbers” option may be used to set “tab” positions within the record (similar 
to setting “tabs” on a typewriter). If tabs are set, the operator may input data, press OCK1, and the utility 
will reposition the print mechanism to the next tab position within the record, and await data input. During 
this repositioning CREATE will fill all character positions left unspecified in the record with a “filler”? (ASCII 
space for source input, ASCII zero for alphanumeric input, and binary zero for numeric zero). The record length 
plus one will be used as a termination tab position, whether or not other tab positions are specified. 
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CREATE can be used for record sizes up to 500 bytes, but since the utility cannot be given input greater 
than the width of the console, tab positions are mandatory on files of larger record sizes. For example, a file 
of 180 byte records requiring alphanumeric input will require at least one tab position (for instance at position 
100). A file of 180 byte records requiring hexadecimal input will require a minimum of three tab positions (for 
instance at positions 50, 100 and 150). The maximum tab size is 115 in alphanumeric input and 54 in 
hexadecimal input. That is, the difference between two consecutive tab positions should be less than or equal 
to 115 in alphanumeric input and less than or equal to 54 in hexadecimal input. 


The EXTENDING option is used to add records to an existing file. The attributes, such as RECORD and 


_ BLOCK sizes, are taken from the old file. The file type is also taken from the existing file. The operator may 


specify “A” alphanumeric input or “N” for hexadecimal input. If neither “A” nor ‘‘N” is specified, “A” is 
assumed. 


Examples: 

To create a source file called “ICFILE”, record size 100 bytes with 5 records per block, tab position set at 

65: | | 
CREATE ICFILE RECORD 100 BLOCK 500 65. 


To create a source file called ““ICFILE” with Record Size 80, block 3, and a maximum of 20 records in the 
file: 


CREATE ICFILE RECORD 80 BLOCK 240 FILESIZE 20. 


To extend a source file called “ICFILE” (note: the utility will automatically prompt the operator for the next 
sequential record number to be created): 


CREATE EXTENDING ICFILE 


To create a data file called ““CFILE” for hexadecimal input with tab positions set at 50, 100 and 150. (Note: 
Default record size is 180, block 1): 


CREATE CFILE N 50 100 150 


The utility operates in two modes: “RECORD INPUT” (entered through PK1) and “RECORD MODIFY” 


The “Record Input Mode” (PK1) is used to enter new records through the keyboard. Characters are input’ 
followed by OCK1 for each tab position. | 


| (entered through PK2). 


The ‘‘Record Modify Mode” (PK2) is used to make corrections to the last record input. The point in the 
record at which alterations are to be made is selected by typing an identify group of characters immediately 
preceding the byte(s) of the record to be altered. The portion of the record to be replaced or inserted follows 
the identifying characters, delimited by a colon (:). If alterations are to be made at the beginning of the record, 
no identifying characters are necessary. 


If OCK1 is used to terminate input, the characters to be altered will replace the corresponding number of 
characters in the record. 


For example, for a record containing “ABCDEF”’, the amendment C:XY:OCK1 will result in “ABCXYF’”’. 
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If OCK2 is used to terminate input, the characters delimited by colons (:) will be inserted at the indicated 
point. The insertion can cause characters in the record to be moved to the right. The shifting of characters ap- 
plies only to those characters from the starting byte to the next higher relevant tab position; characters beyond 
this tab position will not be affected. 


For example, a record specified with tab positions at 4 and 8, contains “ABCDEFGHIJ”. The amendment 
C:WXY: OCK2 will result in “ABCWXYDHIJ”. ! 


Initially the utility will be in the “Record Input Mode”, and on completion of an entry in any mode, it will 
allow the operator to select the mode not in use, or terminate the utility (with PK6). Unless otherwise instruct- 
ed, it will continue in the existing mode. 


If the FILESIZE is specified and records are entered beyond the given filesize, then the error message is 
displayed after (filesize + 2) records have been entered. The last two records will not be written, due to the 
blocking of the output file by CREATE. For example, if the request 


CREATE ICFILE FILESIZE 15 


is followed by more than 15 records entered, then the message ‘OUTPUT FILE TOO SMALL” will be given 
after the seventeenth record is entered; and the utility will go to EOJ without writing records 16 and 17 to 


the output file. 


Output messages: 


MESSAGE 


FILETYPE IS NOT 
SOURCE OF DATA 


ILLEGAL PARAMETER 


LIST - ATTRIBUTE 
SPECIFICATION 
INVALI)D 


ILLEGAL PARAMETER 
LIST - TASS ERROR 


NOT HEXACECIMAL 
CHARACTER INPUT - 
RESUBMIT 


ODD NUMBER OF 
HEXADECIMAL CHAR- 
ACTERS INPLT 
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POSSIBLE CAUSES 


A file other than 
a “Source™” fite or 
a “data™ file was 
specified. 


Specified record and 
Dlock sizé@s are tn™ 
compatible. 


Tab positicns beyond 
end of record were 
specifieds or input 
fields targer then 
capabilities of 


console. 


Character other than 
0-9 ad AwF was Input. 


Warning meSSsSaqe inc* 
Ycating that an odd 
number of hexadecim=- 
at characters waj; 
Input. Wher incut 


mode is "hexadecimal" » 


utility expects even 
number of tnout char 
acters. 


SUGGESTED ACTION 


Check for correct 
fite> check irput 


anc re"anter if 
recessarye 


Check input 


re"erters 


Check input 


re "enter. 


Check tnput and 
rewenter. 


None. Utitity accepts 
the input» but adds a 
Zero onto the eng 
Cright) of the inout» 
to ever it out. 


[messace —remmmcaumes = SUGGESTED ACTION 
; = 


INPUT ERROR @- Input error during Check input and 
RESUBMIT RECORD "Record Modify Mode”. rerenter record 
MODIFICATION modification. 

BYTE WITHIN The identifying Check input ara 
RECORD SPECIFIED string of charact- re-enter the 

NOT FOUND ers for record record modification. 


modification couid 
not be found in the 
record specified. 


UNWANTED KEY Invalid QCK was Feenté€r input and 
PRESSED = PLEASE pressed. termiréete the entry 
RE“INPUT.. 


hith the correct OCK. 


INPUT IMMEDIATELY Chéracters were input Restert the utility 
BEFORE PK6& HAS immeciately before using nodify trode to 
BEEN LOST PK5 was oressed to corréct this record i fi} 
terminate the utility. cesirec. 
These characters witt 
not be written to 
the specified fite. 


OUTPUT FILE TCC Attempt was made to 


List the file to 


SMALL adc records to check which records 
specified file have been entered: 
beyond its maximum then use CREATE 
filesize. File is EXTENDING to add 
Closed with lock. the cesired records. 


Alternatively use 
UPDATE with the 
FILESTIZE option. 


PERMANENT ERROR ON Utility is not able List the file to check 
QUTPUT FILE to write any-more which records have 


records to the new teen entered: then 
disk file because CCFY to a different 
of errors on the file énd continue 
diske File is closed using CREATE 


with lock. EXTENDING. 


RECORD SELECTION Attempt was made to Check input and 
ERROR Select a non~exist- re-enter if 
ant record. recessSary. 


ILLEGAL RECORD Attempt wWasS mace to Creck input ard 
NUMBER SPECIFIED select record greater reenter if 
| than the number of. recesséry. 
records in fite» or 
zero. 
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RECORD REQUESTED 


IS BEYOND £.C.F. 


E.O.F. REACHED 
DURING DELETIONS 


POSSIBLE CAUSES 


Attempt was made to 
select rececrd teyond 
end of file. 


Attempt was mace to 
delete a record | 
beyond end of file. 


SUGGESTED ACTION 


Usually indicates 
update is complete: 
utility terminates 


normétly» no action 


reed be taken. 


Usually indicates 
file update is 
complete: utility 
terminetes normalty» 
no action need he 
taker. 


Note: Refer to “Common Utility Output messages” for additional messages. 
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DA (Disk Analysis) 


This utility allows the operator to read any portion of a CMS-format disk. It is an interactive program, with 
the operator entering a range of commands via the console. 


The utility is commonly used to print the contents of the disk directory. In general, if the PD utility operates 
correctly for a specific disk, then DA should also run successfully. Specifically, the disk cartridge label, the name 
list entry and disk file header for SYSMEM must be intact. (Refer to the CMS MCP manual for details of 
the disk format and directory structures). 


DA disk-name | / filename 


The utility operates in two modes “disk mode” and “file mode”. If no file name is specified the utility oper- 
ates in “disk mode’. 


Disk Mode 


Format: 


In this mode the operator can enter via the keyboard a number of commands. These commands can be abbre- 
viated according to the table provided at the end of this section. The format and meaning of each command 


in disk mode is given below. 
END 
Terminates the utility. 
DCL 
Reads and formats the contents of the disk cartridge label. 


DFH 


Reads and formats the contents of selected disk file headers. This command is followed by other details, given 
here: 


TEMPORARY 

ALL 

OF file-name- 
DFH number 

@ number 

NEXT 


The “TEMPORARY” option displays the headers of all temporary files. 
The “ALL” option displays the headers of all files, and their contents if in use. 


The “OF” option displays the header of the specified file: all headers will be checked and duplicates will 
be displayed if found. 


The “‘sector-number” option displays any sector in disk file header format, where the number is a decimal 
sector address. If preceded by an @symbol, the sector-number is in hexadecimal. This feature can be used after 
displaying other parts of the directory, which include sector addresses for disk file headers in hexadecimal. 


The “NEXT” option displays the header of the next file in the directory. 
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AVAIL.TABLE 
Reads and formats the contents of selected parts of the disk available space, table. This command is followed 


by other details, given here: 


ALL 
| AVAILABLE 
AVAIL.TABLE BAD 
INVALID 
number 
@ number 


The “ALL” option displays the entire available table. 
The “AVAILABLE” option displays entries for available area only. 


The “BAD” option displays entries for bad sectors only. 


The “INVALID” option displays all entries in the available table which are invalid, in that the denen, entry 
does not equal the difference between “start address’ and “end address’’. 


The ‘“‘sector-number” option displays any sector in available-table format, where the number is a decimal sec- 
tor address is in hexadecimal. i 


NAME.LIST 


Reads and formats the directory name list, including the sector addresses of associated disk file headers. This 
command may be followed by other details, given here: : 


NAMES 
| TEMPORARY 
NAME.LIST OF file-name 
| ~number 
@ number 


If no further details are given, then the entire name list is displayed. 
The “NAMES” option displays entries for old (existing) files only. 
The “TEMPORARY?” option displays entries for temporary files only. 


The “OF” option displays the entry for the specified file : all entries will be checked and duplicates will be 
displayed if found. — | 


The “‘sector-number”’ option displays any sector in name-list format, where the number is a decimal sector 
address. If preceded by an @ symbol, the sector-number is in hexadecimal. 


READ 


Reads and displays the contents of any specified sector in hexadecimal and ASCII format. This command 
may be followed by other details, given here: 


NEXT 
READ ONLY some number — 


@ number 
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The “ONLY” option inhibits the display of the information. | 


© The “NEXT” option will read the next sector. Note that after some operations which involve a search, the 
“next” sector may be indeterminate. After a READ of sector n, a READ NEXT will read sector n+1. A 
READ command with no further details is taken as a READ NEXT. 


The “‘number” option reads the sector whose address is the number. If preceded by an @ symbol, the sector- 
number is in hexadecimal. | : 


DISPLAY 


Displays the current sector address and contents of the program’s sector-buffer. The first DISPLAY command 
must be preceded by a READ command. A READ ONLY followed by a DISPLAY is equivalent to a normal 
READ. 


File Mode 


In file mode, the utility can be used to read selected records. Only the following commands are valid: 
READ 
DISPLAY 
END 
The READ command has the same format as in disk mode, except that the ‘number’ refers to the logical 
record number in the file, and a READ NEXT will read the next logical record in the file. The amount of 
information displayed is equal to: the file’s record length. 


General Notes 


In disk mode the sector number starts from zero; that is, “READ 0” will read the first disk sector. 


In file mode the record number starts from one; that is, ““READ 1” will read the first logical record. 


Any I/O error causes the “fetch value” to be displayed, with the current sector address if in disk mode, or 
current record number if in file mode. 


Abbreviations 


For ease of use, input commands and other keywords may be abbreviated, as in the following table: 


READ 

ONLY 

NEXT 
DISPLAY 
END 

OCL 

DFH 

ALL 

OF 
TEMPORARY 
AVAIL.~TABLE 
AVAILABLE 
BAD 
INVALID 
NAME.LIST 
NAMES 
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Output messages: 


mS 


MESSAGE | POSSIBLE CAUSES 


SUGGESTED ACTION 


INVALID PARAMETER No valid disk name 
of file name has 
been specified ir 
the inittating 
message. 


Reenter 


I/O ERROR annnnad The required disk is Check input or 
DISK MOD TERPFINATED not onwLinesr or the KY the required 
Specified file has Cisk. | 
not been found. This 
message is foilowed 
by the Fetch Vatue 
giving reason for 
terminatior. 


SUCCESSFUL READ A DISPLAY command Enter a READ commands 
MUST OCCUR FIRST has been entered then a DISPLAY witl 
before a success* work. 7 
ful read. 


INVALID OPTION An unrecogizZed Check tnput and 
command has been reenter. 


entered. 


input 


NOT VALID IN FILE A command other than Check input. 
MODE READ or DISPLAY has 

been used in file 

mode e 


NONE FOUND No information has 
been found in answer 
to a commard. 


Nonee 


I/0 ERROQRe ee. Attempt to read sector None. The es... gives 


ADDRESS nnnn/ has failed» adcress tyre of failure CERROR 


annnna in decimat and hex. CN READ» BEYOND END OF 
: Utitity will cortinue. FILE,» cr INVALID SECTOR) 


1/0 ERROR.... Attempt to read record None. The «ee. gives 
RECORD nnnn/ has failed» eddress type of failure (see 
annnna in decimat and hex. ébove). 

Utility will continue. 
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DD (Disk Dump) 


This utility allows the operator to back-up (“STORE”) one or more files from a disk to one or more disks 


(cartridge or BSMD) whose capacity is less than the originating media, and later “RESTORE” these files to 
their original state. 


Store Function: 


Format: 
file-name or file-name or 
DD STORE disk-name / group-name TO disk-name / group-name 


The STORE function allows the operator to store a file or group of files between two disk media, where 
the size of the file may be greater than the physical size of the disk to which the file is being copied (destination 
disk). The files to be stored are specified by ‘“‘file-name”’ or ‘“‘group-name” and are taken from the system disk 
unless ‘‘disk-name”’ is specified. Additional files or groups of files may be specified, separated by a comma. 


When the original destination disk is filled, the utility will request the name of the next disk to be used. The 
disk name is accepted from the operator who should then power off the drive using the “PO” intrinsic, insert 
the new disk into the drive, and use the ‘“‘RY” intrinsic to allow the utility to continue. When all the files have 
been copied, the original destination disk must be re-inserted before DD will go to End of Job. 


STORE re-computes block sizes for optimization and to allow a file to be copied to multiple disks. As a re- 
sult, these files will not be usable as in their original form. The files must be RESTORED. 


Examples: 


To store a file called PR200 from the disk PRI to the disk PRBU: 
DD STORE PRI/PR200 TO PRBU/PR200 


To store a group of files beginning with the letters “PR” from the disk PR2 to the disk PRBU: 
DD STORE PR2/PR= TO PRBU/PR= 


To store a file called PRCLEF from the system disk to the disk PRBU: 
DD STORE PRCLEF TO PRBU/PRCLEF 


The information needed to restore these files is kept in a file called “DDSTRESTORE” which is created 
when DD begins processing. Because of this, DD may not be run twice to the same destination disk or the 
information required to restore the first set of files will be lost. ° 


Restore Function 


Format: 


file-name or file-name or 
DD RESTORE disk-name / group-name TO disk-name / group-name 


This option allows the operator to restore a file or group of files between 2 disks where the disk from which 
the files are being copied (source disk) was generated by “file-name” or “group-name”’. Files are copied to the 
system disk unless ‘“‘disk-name” is specified. Additional files or groups of files may be specified, separated by 
a comma. 
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When all files have been restored, the utility will inform the operator what disk must be inserted next to 
continue the transfer. Power off the disk drive using the “PO” utility, insert a new disk, and use the “RY” 
intrinsic to continue the utility. ) _ 


Examples: 


To restore a file called PR200 from the disk PRBU to the disk PRI: 
DD RESTORE PRBU/PR200 TO PR1/PR200 


- To restore a group of files beginning with the letters “PR” from the disk PRBU to the disk PR2: 
DD RESTORE PRBU/PR= TO PR2/PR= | 


Output messages: 


IMESSAGE POSSIBLE CAUSES SUGGESTED ACTICN 


group“name = NO Specified group Check input and 
FAMILY MEMBERS 715 not on disk. reterter if necessary; 
FOUND Check for correct 
Cisk. 


FILE NAME TOOQ Specified file Re-input correctly. 
LONG name its tonger 


thén 12 characters. 


filename NOT Attempt was made to 
STORED = ILLEGAL store a system file 
REQUEST (that is» MCP» 

interpreters» etc). 


ENTER NEW PACK ID Program requests Enter AX mix number 
FOR CONTINUATION next disk for cf procram and new 
OF TRANSFER STGRE continuation Cisk néme to which 
ACPT disotay. STCRE will continue 

tc ccpy. | 


INSERT PACK disk Continuation disks keeponc to ACPT mess 
name FOR CONTIN- | are required. age with AX mix number 
UATION OF TRANSFER cisk*name. Power 
INSERT NEWPACK off (PO) disk 
disk*name FOR currently filled» 
CONTINUATION OF Insert new disk» type 
RESTGRE | "RY" ta contirue 
procéssing. 


NOT FIRST PACK OF Source disk specifiec Fower cf f (PO) in- 
A STORED SERIES in RESTORE is not © apercepriate disk» 

first disk of a stor” Insert proper cisk. 
ed series of disks. | 


file-name STORED STORE or RESTORE 
TO filename successful 
file*name RESTORED | 

TO file-name 


NOTE: Refer to “Common Utility Output Messages” for additional aid. 
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DUMP (Dump Files to Library Tape from Disk) 


This function, a part of the LD allows the operator to copy files from disk to library-tape. 


Format: 


| LD | DUMP TO library-tape-name | FROM disk-name 
file-name or 
group-name < BOTH> 


If the <BOTH> option is used following a request to dump a keyfile, the associated data file will also be 
dumped following the keyfile on tape, provided the data file is on disk. 


Examples: 


To dump a group of files beginning with the letters ““AR” from the system disk to ARTAPE: 
DUMP TO ARTAPE AR= 


To dump a file called ARTASK and a group of files beginning with the letters ““DCS” from a disk called 
ARDISK1 to a tape called ARTAPE: 


LD DUMP TO ARTAPE FROM ARDISK1 ARTASK DCS= 


To dump a keyfile called AR200K and its data file from a system disk to ARTAPE: 
DUMP TO ARTAPE AR200K <BOTH> 


Since “DUMP” is a part of the utility ““LD’’, “LD” 1s actually what will appear in a mix message. To discon- 
tinue the DUMP function, ‘DS’? mix number/LD must be used. 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


NO FILES IN Snecified group name Check input anc 

THE FAMILY not found on disk. rementer if necessary; 
group~name OK Check for correct 

DISK disk-name Cisk. 


NO FILE fit e"name Specified file was Check input and 
ON DISK disk*name not found on disk.e reenter if necessary» 
OR DUMP © Check for correct 
cisk. 

file-name NOT File to be copied 15 None: utlity will 
DUMPED - IN QUTPUT in use and cannot be rot dump this file 
USE* DUMP ABANDON- copied. If “fUMP but will cont inue 
FE) TAPE BEING ABANDONED” message is with next file to 
PURGE). given» tape 1S purged be dumrced- 

and utility goes to 

EQJ. 
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filename NOT 
DUMPED - HAS BEEN 
REMOVED. 7 
DUMP ABANDONED - 
TAPE BEING PURGED. 


filec-nane NOT | 
DUMPED = HAS BEEN 
ALTERED = OUMP 
ABANDONED = TAPE 
BEING PURGED. 


file"name LOAN 
DUMP DISCREPANCY 


NO FILES TG 
DUMP 


file-name 
DUMPED 


DUPLICATE file-name 
ALREADY BEING 
DUMPED 


ifile-name NOT | 
DUMPED - DATA FILE 
NOT ON LINE 


File to be coptec was 
removed between start 
of DUMP and time wher 
file was to be copiec 


to tape- Tape is purged 
and utility soes to End 


o f Job. 


‘Contents of file to 


be copied were alter? 
ed between the start. 
of the dump and the 
time the file was to 
be copied to tafe. 
Tape is purged and 
utility goes to Eng 
of Job. 


End of File reached 
before expectece Disk 
File Header may con* 
tain errors. 


No files were founc 
on this disk to copy 
to tapee | 


DUMP successful 


More than cne recuest 
was made to DUMP this 
file. 


<BOTH> option was 
specified» put data 
file was not found 
on diske 


SUGGESTED ACTION 


None 


None 


Check input and re- 
enter if necessary? 
Check for correct 
tepe. 


None. 


If specified cata 


file dump is 


required» supply 
DUMP with backup 
Copy of fite if it 
exists. | 


Note: Refer to “Common Utility Output Messages for additional messages. 


FL (Display File Attributes on Self-Scan) 


This utility allows the operator to display detailed information about particular files or groups of files on disk 
upon the self-scan screen. The information given is similar to the LR utility. 


Format: 


file-name or 
FL disk-name / grougname 


The utility uses the following PKs when more than one file is specified: 


page to 
next 
screen 


Examples: 


To display information about all entries on the system disk: 
FL = 


To display information about a file called PR200 found on disk called PR2: 
FL PR2/PR200 


To display information about a group of files beginning with the letters “PR” found. on the system disk: 
FL PR= | 


Output format: 


The utility will fill eight lines on the self-scan screen with information about one file. 
line 1: FILE NAME (DDDDDDD/FFFFFFFFFFFF) 
line 2: FILE TYPE (TITTTTTIT) 
line 3: SIZE: ACTUAL (XXXXXXX) MAX (XXXXXKXX) 
lines 4,5: headings 
line 6: DATE CREATED (YYDDD),LAST ACCESS DATE (YYDDD), 
RECORD SIZE (XXXXX), RECS/BLOCK (XXXXX) 
line 7: AREA MAP (seseeeeeeess) 
line 8: OVERFLOW ON DISK (DDDDDDD) 


Note that the OVERFLOW ON DISK will not be displayed if the file has no overflow areas allocated. 


The first line contains disk name specified by DDDDDDD on which the file specified by FFFFFFFFFFFFF 
resides. | | 
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In the second line the FILE TYPE entry will contain one of the following: 


SYSTEM (system file) 


CODE COMPILED YYMMDD (object code file and compilation 


date) 
DATA (normal data file) 
SRCELANG (source language file) 


The third line displays the actual file size and maximum file size specified for the file. 


The fourth, fifth, and sixth lines display the date of creation and the date the file was last accessed in 
YYDDD (Julian) date format. The record size displays the number of characters per record and RECS/BLOCK 


displays the number of records per block. 


In the seventh line sixteen characters are displayed to show the allocation of the sixteen areas into which 


a file may be broken. Each character may be one of the following: 
« unallocated | 
B allocated on this disk 
O allocated on the overflow disk 


Output messages: 


POSSIBLE CAUSES 


Specified file nct 
found on this disk. 


specified group was. 
not found on this 
disk. 


_ Note: Refer to “Common Utility Output Messages” for additional aid. 


SUGGESTED ACTION 


Check tnput are 
re"irpdut if necessary 
Check for correct 
cisk. 


Check input and 
re"input 1¥f necessary> 
Check for correct 
cisk. 


FS (File Squash) 


This utility allows the operator to remove all deleted records from a data file. Records are normally “‘deleted”’ 
‘(that is, hexadecimal @FF@ are written over the records) through an appropriate application program. The FS 
utility will remove these previously deleted records, allowing additional records to be added to the file. 
Format: 


FS | disk-name / file-name INTO | disk-name / | file-name 


The “file-name” identifies either a data file or a keyfile. If a keyfile has been specified, the name of the 
data file is obtained from the information held in the keyfile. 


If a keyfile is specified, then the utility will reconstruct this keyfile so that it relates to the modified data 
file. 


While the utility is processing, no other program may access the data file (or the keyfile if one is specified). 


If only one file-name is specified and no other options are used, the file squash will be carried out in place, 
‘and no new data file will be created. If a keyfile was specified, then a new keyfile with the same ‘file-name”’ 
will be recreated by the SORT. | 


If 2 file-names are specified, the data file will be squashed into a new file, and the keyfile (if specified) will 
be recreated by the SORT. If the first file-name specifies a keyfile, then the new keyfile will have the name 
indicated by second file-name, and the new data file will have the name of the new keyfile name, with the 
letters ““QQ” attached to the end of the name. 


Examples: 


To squash the file, PR200: 
| FS PR200 
To squash the file, PR200 and create a new file, PR200B: 
FS PR200 INTO PR200B 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


filectname SGQUASHEC FS success ful- 
FROM n RECORDS 10. Original and result= 
m RECOROS ing fliesizes of the 
| data fite indicated. 
mn" and “m™" are 
decimat numbers up 
to 7 digits each. 


KEYFILE file-name "file-name™ indicated None. 
RECONSTRUCTED by operator itnout 
identified by keyfile 
anc FS has success”™ 
fully squashed the 
data file and recon 
structed the keyfile. 
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MESSAGE POSSIBLE CAUSES. 


KEYFILE SORT SORT utility was not None. 
FAILURE | able to property con- 


Struct a keyfile. 


Note: Refer to “Command Utility Output Messages” for additional aid. 


ICMD (Industry Compatible Mini Disk Access): 


This utility allows the operator to access industry-compatible mini disks (ICMD). 


Format: 
LR disk-name 
ICMD PG disk-name 
or 
ICMD COPY disk-name/file-name ICMD TO disk-name/file-name FILESIZE number 
or 


ICMD COPY disk-name/file-name TO disk-name/file-name ICMD 


The first function of the utility (LR) allows the operator to print the disk directory of the ICMD. The utility 
will print a line of information for each file on disk. 


The second form of the utility (PG) allows the operator to purge (erase) all files from an ICMD. The utility 
will replace all files by a single zero-length file called “DATA” to which is assigned all the disk space available 
to the user. : 


The third form of the utility allows the operator to copy an ICMD file to a CMS file. The CMS file will 
have the largest block not exceeding 180. If the FILESIZE of the CMS file was not specified, it will be calcu- 
lated from the header of the ICMD file. Note that when copying a Multi-Volume File (file which resides on— 
more than one disk) the FILESIZE option will almost certainly be required. 


The fourth form allows the operator to copy a CMS file to an ICMD file. The maximum record size of the 
CMS file must be 128 bytes (the ICMD sector size). 


Examples: 


To print the disk directory of an ICMD disk called PR2: 
ICMD LR PR2 


To purge all the files from the ICMD called PR2: 
ICMD PG PR2 


To copy a file called PR200 from the CMS disk called PRI to an ICMD disk called PRBU: 
ICMD COPY PRI/PR200 TO PRBU/PR200 ICMD 


To copy a file called PRFILE from the ICMD called PRBU to the CMS disk called PRI: 
ICMD COPY PRBU/PRFILE ICMD TO PRI/PR200 


Output messages: __ 
MCOSSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ENTER VGL-ID FOR Program is about to Enter eppropriate 
"filename" n disolay an ACPT rem cisk*name. 

questing the next 

disk*name contain 

ing the Mutti-Volume 

File “file"ngeme”. 

"n™ 1s the sequence 

number to be uSed>» 

or btank if none- 
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SUGGESTED ACTION 


VOLUME nm OF "file- Sequence number “n* Remove inappropriate 
name" OUT OF SEQUENCE of “file-name” was disk from disk drive 


not expected at this CPO cannot be used 
pointe | with ICMD). Replace 
CEx? program was with cisk having 
expecting cisk with correct Sequential 


sequence number of number for this file. 
2 and oferator st- ! 

pptied disk with 
Sequence number 4). 


DUPLICATE FILE File cannot be copiec Cory this file white 


"filename" to ICMD as a file changirg its name. For 
of the same name examples if file-nare 
already exists. Disk MYFILE is already on 
Cannot Contain 2? the IC*¥D, enter ICMO 
files with the same COPY DISK/MYFILE To 
name - ICDISK/YOURFILE Icrre. 


NO FREE LABEL ON File cannot be copied Reptece ICM) with 

"disk=name™ to ICMD as its disk. another ICMD having 

directory is fultt. Cirectory space. 
Re~attempt ICMC utility; 


NO SPACE FOUAD File cannot te Copiec FG ICC and remattempt 
DN "disk=name"™ | to ICMD as no unused Copys or select another 
space coulc be founc. cisk or which to CODY. 


Note: If any of the above messages (including ‘‘disk-name’” NOT FOUND and “filename” NOT FOUND) 
is Output in response to the initiating message, the utility will go to End of Job. If in response to an ACPT, 
the utility will repeat the message: ENTER VOL-ID FOR “file-name” “n’’. 


BAD INDEX TRACK ICM) has an error on Select another ICME 
ON disk=name SECTOR Treck 0 and cannot — for this function. 
number ‘be used by this ut- 

ility. Utility goes 

to £OJ. 


RECORD SIZE OF The file cannot te Use MCP COPY cttility 


filename EXCEEDS copied to the ICD to change record/ 
123 | aS its record size Elock sizes. 
7S more than 1285. CEX: COPY CMSFILE TO 
the maximum for an CMSFILE RECORD 128» 
ICMD. Utility goes BLOCK 128) 
to ECJ. Then use ICMD COFY 


to comelete transfer. 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


NEXT SEQUENCE NUMBER No more disks may Use MCP COPY utility 
OF filename EXCEECS be used» as the to break file (see 

99 maximum for an ICM) COPY utility). Then 
is 99. Utility qces use ICM) COPY to 

to FQJ. | complete transfer. 


INPUT ERROR ON Irrecoverable error File cannot be copted 

file-name RECORD | was found on read- from the ICMD»s use 

number ing record “nurher” backuo ICMf if avail- 
from the ICMO. Util- eble. 

ity goes to EOJ. 


QUTPUT ERROR ON Irrecoverable error Disk cannot be used. 
filetname RECORD was found on writing Use another ICMOD. 
number record "number™ to 

the [CMD. 


file-name T9 ICMD COPY function 
file*name COFIED successful - 


diskename PURGED ICMD PG function 


successful. 


Note: Refer to Common Utility Output Messages for additional aid. 
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IR (Initiate Log Recall) 
(a function of SYS-SUPERUTL) 


This function will initiate recall and go back in SYS-LOG files after skipping the number of entries specified 
by the operator (that is, 5 digit “offset”’) and display the required message. 


Format: 


IR Offset 


Examples: 


To initiate recall after 12 entries and display the message on the console: 
IR 12 | 


To initiate recall of the message just given: 
IR 1 


Output messages 


POSSIBLE CAUSES SUGGESTED ACTION 


CANNOT LOCATE DESIRED The tog files have 
LOG ENTRY been transferred 
| using TL utitity 


Offset is greater | Decrease the value of 
than number of entries offset and reenter. 
in log file 2 
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KA (Analyze Disk Space Assignment) 


This utility provides the operator with a map of all space used on disk by specific files, or available for other 
use. The printout is in ascending disk address order in terms of areas and their assignment. 


KA is capable of analyzing space assigned to one or more files, one or more groups of files, or the available 
areas. 


Special reporting is given if the group identifies all files on the disk (that is, disk-name/=). In addition to 
an analysis of the areas allocated to each file, this report will show the space assigned to the disk directory, 
temporary, available, bad, and missing areas. The temporary areas are those which are allocated either to tem- 
porary files or to the virtual memory. 


If files are created, extended, or deleted by the system during the processing of KA the map will not be 
accurate. It is therefore necessary that KA be run only when no other programs are in the mix. 


The analyzed output will be to a line or console printer, and will print the areas in ascending disk address 
order associating with each area its first sector address, its length in sectors, and its status. The status will be 
either allocated, available, temporary, bad, or missing. If the area is allocated, the file name of the file to which 
the area is assigned will also be listed. If a particular file or family is not on-line, then this is indicated on the 
printout. 


If the option DSKAVL is selected, then an analysis of the available areas on the disk specified by ‘“disk- 
name” (or system disk if no ‘‘disk-name”’ was specified) will be printed. 


Format: 
file-name or 
KA disk-name / group-name 
or | 
KA | disk-name/ DSKAVL 
Examples: 


To analyze disk space assignments of all files on system disk: 
KA = 


To analyze disk space assignments of all files on the disk called PR2: 
KA PR2/= 


To analyze disk space assignments for a group of files beginning with the letters, “PR” on the system disk, 
and a file called PR200 on a disk called PR2: 


KA PR= PR2/PR200 


To analyze available areas on the disk called PRBU: 
KA PRBU/ DSKAVL 
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Output format: 


Six columns of information are output. The column headings, the format of the values these columns contain, @ 
and the significance of these values are as follows: | | 


HEADING | VALUE : SIGNIFICANCE 


AREA ADDRESS 8 digits — | Sector address of start 
| 6 hex. digits a cf area 
AREA LENGTH 8 digits Number of sectors in 
6 hexe digits this area 
STATUS | | a, characters | see Note 1 
FILE NAME | 12 characters See Note 2 


Note 1: The status will be one of AVAILABLE, TEMPORARY, BAD, or * MISSINGs, depending on 
whether the area is available, allocated to a file, denoted as temporary, unusable, or lost. 


Note 2: If the area is ASSIGNED, then this field will contain the identifier of the file residing in the area. 
Otherwise it will be blank. 7 . : | 


The status *MISSING¢# occurs if an area is not referenced from anywhere within the file directory or available 
table. This may be because the area is in fact lost, or because existing files have been opened, have had further 
areas allocated to them and are still open during the processing of KA. | 


If fixed disk is being used, three areas are reserved for MTR purposes with the status marked as “BAD”. 
The area lengths are 256, 128, and 128 sectors respectively. | @ 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


*AREA APPARENTLY Area is cortaineo KRotify field eng- 
ASSIGNED TWICE partly or complete ineering. DO NOT USE 
ly in an area orev- DISK. It may be possibte 
lousty tisted. to recover any file not 
: involved» usirg CCPY. 


*AREA ASSIGNED Area is assigned Notify field eng- 
BEYOND MAXIMUM beyond the address- Ineering. DO NOT 
ADDRESS* able space. USE CISK. 


INOTE:s OUTPUT FILES Files were open on KA printout may not 


ON DISK WERE OPEN disk white XA was © te cometetely acc- 
DURING THIS EXES- processing. NMther urate. Begin KA when 
UTION OF KA programs may have no other programs 
been in the mix | ére in the mix. 
when KA was procs : 


essing. 


input NOT FOUND IN Specified file is Check input and rem 
{DIRECTORY ON THIS not on disk. 7 input if necessary; 
DISK. Check for correct 
| | | | Cisk. : 


input NO FILES IN Group of files 
DIRECTORY FOR Specified 15 not 
THIS FAMILY on disk-e 


TABLE SIZE EXCEEDED Number of tines of 
output required is 
greater than KA 
permits. Maximum 
permitted is about 
20 pages of output. 
KA ends. | 


NO OUTPUT GENERATEC Disk directory cont” 
BY KA ains no file names 
to print. 


Note: Refer to “Common Utility Output Messages” for additional aid. 
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Check input and rem 
input 1f necessarys 
Check for correct 
cisk. 


Check for correct 
cisk; 

Check input ana 
re“input if necessa 


ry e 
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KX (Disk Allocation Information) 


(a function of SYS-SUPERUTL) | po: | ® 


This function will allow the operator to display the name of the first file found on the disk specified by ‘“‘disk- 
name” (or on the system disk if no ‘‘disk-name’”’ is specified) whose total number of sectors allocated is equal 
to or greater than “number” (assumed zero if not specified) | 


KX | | disk-name | number 


After each display, which will include the information of the current numbers of temporary and available sec- 
tors, the KX function of SYS-SUPERUTL remains available, waiting for one of the following input responses: 


Format: 


A call on any other function of SYS-SUPERUTL: this will terminate KX. 
KX or KX NEXT To display the next file name, if any, otherwise KX will go to END. 
KX RM or KX REMOVE To remove the file whose name has just been displayed. 
KX END To terminate KX. 

Examples: 


To display the name of the first file on the system disk whose size is equal to or greater than 250 sectors: 


KX 250 | @ 
To display the name of the next file whose size is equal to or greater than 250 sectors: 7 
KX NEXT 8 


To remove the file just displayed: 
KX RM 


To terminate KX: | 
| KX END 


Output messages: 


I MESSAGE POSSIBLE CAUSES | SUGGESTED ACTION 


END KX KX success ful 


filename - ntmber Normal KA disptay 

SECTCRS+ AV. number» showing current 

TEMP Cor TEMPORARY) number of sectors» 

number available anc 
temporary on 
disk. 


input IS AN UNACCEPT= Typing errcr. Check input and 
ABLE RESPONSE FOR Kx | “eas re"erter. 


See SYS-SUPERUTL messages also. 
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LB (Look Back in Log) 


(a function of SYS-SUPERUTL) 


This function will Look Back to continue recall in the direction of earlier messages with a screenful of mes- 
sages. If the serial printer (SPA) is used as the console, then the function will display a number of messages 
calculated by the length of messages and width of console. 


Format: 
LB 


Example: 


To look back and display the messages: 
LB 


LB can be initiated only after IR, LB, and LF. 


Output messages 


MESSAGE PQSSIBLE CAUSES SUGGESTED ACTION 


IR REQUIRED BEFORE IR function was not Initiste IR then 

i8 CAN BE DONE initiated before LPB. resirptt LB. 
© CANNOT RECALL LB LB has reached the 

BEYOND THIS FOINT becinning of this 


tog file 
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LD (Tape Library Utility) 


This utility allows the operator to maintain library tapes. It is divided into the following four separate ‘‘sub- @ 
programs” (functions): | | 


ADD (tape-to-disk file copy) | 
LOAD (tape-to-disk file copy; duplicates are removed from disk) 
DUMP (disk-to-tape file copy) 
UNLOAD (disk-to-tape file copy; files are deleted from disk 

after being copied to tape) 


On the B 80 these four functions can be invoked directly: the MCP will recognize that they are part of the 
LD program and load LD from the system disk, passing LD the appropriate information. For example, the input 


DUMP TO ARTAPE AR= causes the same action as 
LD DUMP TO ARTAPE AR= 


If LD does not reside on the system disk, the user-disk name and ‘LD” must be specified. 


Should the operator request a “mix message” (see MIX intrinsic) while any of the 4 functions are running, 
“LD” (not the name of the specific function) will appear in the mix. 


Similarly, to discontinue any of the four functions, a message of: “DS mix number/LD” will be required. 


Detailed descriptions of ADD LOAD, DUMP, and UNLOAD and associated output messages are provided 
under the name of the function. : 
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LF (Look Forward in Log) 


(a function of SYS-SUPERUTL) 


This function will look forward to continue recall in the direction of later messages with a screenful of mes- 
sages. If the serial printer (SPA) is used as the console, then the function will display a number of messages 
calculated by the length of the messages and the width of the console. 


Format: 
LF 


Example: 


To look forward from last recall and display messages: 
| LF 


LF can be initiated only after IR, LB, and LF. 


Output messages 


MESSAGE POSSTRLE CAUSES SUGGESTED ACTION. 


IR REQUIRED SEFORE IR was not initiated | Initiate IR and ther 
LF CAN BE DONE before LF reenter LF 


CANNOT RECALL LF LF has displayed the 
BEYOND THIS POINT most recent entry In 
| the tog file 
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\l 


ALPHABET ICHAT 


A 
p 


HE «K\ DECIMAL 


\t 


LIST (File List) 


This utility allows the operator to list in whole or in 
to the line printer or to the console printer. 


| : fa starting : ‘number of 
A record records 
x <KEY> 


number to list 
If the “A” option is chosen the file will be listed in alpha characters. The ‘‘N” option will list the file entirely 


in hexadecimal. If neither the “A” nor ‘“N” options are selected, the file will be listed in both alpha and 
hexadecimal. 


part files on any CMS device. Output will be either | 


Format: 


LIST file-name 


If the file to be listed is a keyfile, the utility will list the associated data file in the order of the keyfile unless 
_ the <KEY> option is specified. When the <KEY> option is used, the utility will list the keyfile itself. 


The operator may also list selected parts of a file by specifying the relative record number at which printing 
should begin and the number of records to be printed from that point. 


Examples: | File wae’ DISE °, F 


To list the records of a file called PROGSRC as alpha: — 
LIST PROGSRC A 


To print the first record only of a file called PR200 in hexadecimal: 
LIST PR200 N 1 1 | 


To list records 100 through 149 of PROGSRC as alpha: 
LIST PROGSRC A 100 50 


To List Keyfiles: 


Assume there is a keyfile called PR200K which refers to a data file called PR200. 
The statement 


LIST PR200K N <KEY> will list all records of the keyfile PR200K in hexadecimal. 


The statement 
LIST PR200K N will list all records of the data file, PR200 in keyfile order in hexadecimal. 
Additional Capabilities 


_ Further features of this utility are summarized in the railroad chart given in Figure 4-3, which gives the com- 
plete input specifications. ? : 


Non-disk files 


Files on media other than disk may be listed. Abbreviations for valid devices are as follows: 
MTP — magnetic tape or cassette | 
CRD — punched cards 
PTP — paper tape 
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* < file-name > 


— LIST 


< f-spec> 
< f-spec > is defined as : 
A 
1 
N 
MTP 
PTP 
1 CRD 
< file-name > — 
/ RECORD <rs> 
1 BLOCK ————————<bs> 
1 TAPE.MARKS — <nt> 
{ NO.LABEL 


1 KEY > 


<r-spec> is defined as : 


Eceeeneaeinne ANE benny 


| < r-count> 
< record-key > 


— <record-key > 


Figure 4-3. Railroad Chart for List Utility — 
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Examples: 


To list a cardfile called PRFILE in alpha: 
LIST PRFILE CRD A 


To list the first 10 records of a CMS labelled magnetic tape called PRTAPE: 
LIST PRTAPE MTP 1 10 


(Note: this assumes record size of 180 bytes). The tape or cassette to be listed should be a tape created by the COPY 
utility. Library tapes and non-CMS tapes should be treated as unlabelled (see below). 


Unlabelled tapes 

Input tapes having no CMS labels (‘‘unlabelled” tapes) may be accessed by the LIST utility. 

The NO.LABEL option allows the listing of unlabelled files. Upon recognizing an unlabelled file, the a 
will print a “DEVICE REQUIRED” message. The operator must then respond with an appropriate “AD” i 
put message (see ““AD”’) to identify the unlabelled file. | 

The end of file recognition for unlabelled files is determined by Gneuare count. The TAPE.MARKS option 
allows the operator to specify the total number of tapemarks which will indicate end of file to the utility when 
listing an unlabelled file. The default value is 2. Each tape mark which is encountered will contribute to this 
total. Therefore, a standard labelled CMS file will be listed up to, but excluding, the trailing label if NO.LABEL 
and 2 tapemarks are specified. (A labelled CMS file consists of “Label, Tape mark, data, tape mark, label‘). 
The operator must be aware of the format of any file which is to be listed when using the NO. LABEL option. 

If the RECORD size is not 180 bytes, refer to the section on Record/Block modifications. 

Example: 


To list the first file of a | magnetic tape with non-standard label (the format being: label, a data, tape- @ 
mark): | 


LIST TP MTP NO.LABEL TAPE.MARKS 2 


Note: MCP will issue a message asking for unlabelled tape TP. Operator must respond with “AD” input. 
Additionally, the first line of the listing contains a list of the non-standard label. 


Record and block sizes 
The listing is record-oriented. The following record sizes are assumed: 
Disk = (Disk File Header) from file itself 
Labelled tape/cassette = from tape label 
Unlabelled tape = 180 bytes 
Cards = 80 or 96 bytes depending on device. 
If different values are required Record and Block sizes may be specified. 


Example: 


To list an unlabelled tape containing 10-byte records with 10 records per block: 
LIST TP MTP NO.LABEL TAPEMARKS 2 | 
RECORD 100 BLOCK 1000 


For magnetic tape or cassette files the record size must be specified if it is greater than 1024 characters, other- 
wise the utility will not be able to read this file and therefore no list will be produced. If the record size is 
specified and no block size is specified then the block size will be set to the same as the record size. For unla- 
belled files the default record and block sizes are 180 each. 


Note: Care should be taken. to ensure that the record and block sizes specified are compatible with the 
physical block size on the tape. The block size specified must be an integer multiple of the record size. The 
utility will attempt to identify inconsistencies when using labelled CMS files. Any inconsistency not isolated by 
the LIST will cause MCP to discontinue (DS/DP) the utility. | 


Selected file list 
More than one selected portion of the input file may be listed. Pairs of numbers may be specified within 


each pair the first number specifies a relative record number and the second specifies number of records to 
be listed. If an extra number is specified the last number specifies listing from that record to the end of file. 


Example: 


To list records 100 to 149, 300 to 499, and 1000 to end of file. 
LIST FILE1 100 50 300 200 1000 


Selected indexed file list 


For indexed files, listing of records can be selected based on content of the key. There are 2 options: the 
number of records can be specified or an ending key value. 


Examples: 


POR is a keyfile containing personnel records. To list 15 records from the corresponding data file starting 
from the record with personnel number 01786: | | 


LIST POR 01786 15 


Using same keyfile to list all data records from personnel number 01786 to 18000: 
LIST POR 01786 — 18000 


Note: the second option is specified by the hyphen in the LIST statement. Note that at least one space is 
required before and after all key values (personnel numbers in this case). 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


number number IN Frror found in pair Check input anc 
filename NOT LISTED of numbers for set- reenter. 
| ected record list 

optione- One record 

number in the catir 

indicates a seCtion 

of the fite at a 

lower 

file address than a 

previously specified 

Section. This pair 

is ignored by LIST. 


2007258 4—61 


MESSAGE | POSSIBLECAUSES SUGGESTED ACTION 


filename EXHAUSTED End-of"file was — Check input and 
DURING number encountered while the re-erter if necessary. 
number sectior of the file 

| indicated was being 
copied. 


filename EXHAUSTED Endwof"file encount™ Check input and 
DURING RANGE ered while section of remerter if necessary. 
record "key record file indicated is 

key being listed; or ro 


or ; records were found 
filename EXHAUSTED in range of the 2 
DURING RANGE record keys. 


record key number 


NO RECORDS FOR Specified file cont” Check for correct 
LISTING FROM ains no records to file-neme. 
filename fist. 


filename NOT ACCEPT- LIST has encounter Check input arc 


ABLE - RECORC SI7E ed a fite witin a reenter. 
OF number IS GREATER record size oreat= 

THAN THE MAYIMUM er than expected. 

SPECIFIED FOR THIS This can happen if 

RUN - RESUBMIT a Magnetic tape file 


with a record size 
greater than 1024 
characters is 
Submitted to the 
utility without the 
record size teing 
property specified 

In the initial input. 


file-name DATA FILE Utility carnrot tocate Check for correct 
NOT FOUND data file pertéining mediums 

to the keyfite 
specifications. 


Note: Refer to “Common Utility Output Messages” for additional aid. 
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LOAD (Load Library Tape Files to Disk) 


This function, a part of the LD utility, allows the operator to copy files from a library tape to disk. As files 
are copied to disk, any duplicate files will be automatically removed from disk by the function. 


Format: 


| LD LOAD FROM library-tape-name | TO disk-name 
file-name or 
group-name < BOTH> 


If the <BOTH> option is used immediately after a request to copy a keyfile, the associated data file will 
also be copied, provided that the data file does not precede the keyfile on the library tape. The keyfile will 
be altered to refer to the disk which now holds the data file (rather than the disk from which the data file 
was dumped). — 


| Examples: 


To copy all files from a tape called PRTAPE to a system disk: 
LOAD FROM PRTAPE = 


To copy the file called AR300 from a tape called ARTAPE to a disk called ARBU: 
LOAD FROM ARTAPE TO PRBU AR300 


To copy files called DCSTSK, and PRTASK from a tape called PRTAPE 
LD LOAD FROM PRTAPE DCSTSK PRTASK 
To copy from a tape called PRTAPE the keyfile called PR200K and its associated data file to the system 
disk: 
LOAD FROM PRTAPE PR200K <BOTH> 


Since “LOAD” is a part of the utility “LD”, “LD” is actually what will appear in a mix message. To discon- 
tinue the LOAD function, “DS mix number/LD”’. . 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


file-name LOADED LOAD successful 


file-name REMOVED LOAD successful: 
original file on 
disk was removed. 


Library tape*name Tape does not have Frovide utility with 
NOT A RECOGNIZED a recognizable correct tapes 
|DUMP TAPE | header. DS the LD utitity 
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POSSIBLE CAUSES 


SUGGESTED ACTION 


NO FILES INTHE Specified group Check input ard 
FAMILY qroup*name was not found on re"erter if NecesSarfry>; 
ON TAPE tibrary- disk. Check for correct 

Cape"name FOR LOAD tape. 


NO FILE file-name Specified file was Check tnput ang 
ON TAPE tibrary- not found on tape. re"enter if necessary; 
tapec-name FOR LOAD , Check for correct 

| tace. 


file-name LOAD/DUMP Enc of File enceunt- 
DISCREPANCY ered before expectec. 
Disk File Header 

may contain errors. 


NO FILES TO LOad No files were found Check input and 
on this tare to reenter if necessary; 
CODY. Check for correct 


tape. 


filetname DATA FILE Data file for this Check if data file 
NOT FOUND ON TAPE keyfile does not  €@poeérs before key fite 
FOR LOAD follow on tape. It cn taoe Cuse TAPEPD); | 
Cannot be copied. if so» load full tape to 
Keyfile was copied. cisk. 


Note: Refer to “Common Utility Output Messages” for additional messages. 
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LR (List Directory) 


This utility allows the operator to print detailed information about particular files or groups of files on disk. 


If a file has areas on an associated overflow disk, then the disk name of the overflow disk is printed beside 


each relevant area address and size. Note that the addresses for the areas on an overflow disk are not necessarily 
correct. 


If a particular file or group is not found on a specified disk, this is indicated on the listing. 


If “<ASCENDING>” or “<A>” is selected, the utility will print the information requested in ascending 
order of file-names. 


If “number” is specified after the LR of an entire disk (that is, LR ARDISK2/=), then LR will only print 
information about those files whose total number of sectors allocated is greater than “‘number'‘; this will be fol- 
lowed by a listing, with totals, of all available and temporary areas on the disk. 


An output line concerning a keyfile will normally be followed by a second line showing the name of the data 
file to which this keyfile points and the key offset and length. 


The heading lines printed at the top of each page will provide a good deal of information about the disk 
itself. 


Format: 


file-name or <A> or | | 
LR disk-name / group-name < ASCENDING > number 


Examples: 


To print the entire directory of the system disk: 
LR = 


To print the entire directory of ARDISK2 in ascending order: 
LR ARDISK2/= <A> 


To print information about the file called ““AR200” and a group of files beginning with the letter ‘““C’” only: 
LR C=, AR200 


To print information only about files on the system disk which have been allocated greater than 1000 sectors: 
LR = 1000 


Output format: 


Fourteen columns of information will be output to the printer for each disk for which information is re- 


quested. The column headings, the format of the values these columns contain, and the significance of these 
values are as follows: . | 
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HEADING VALUE SIGNIFICANCE 


FILE NAME 12 Characters 7 File néme 
ACTUAL SIZE ? digits Number of records 
| currently contained 
| in file | 
MAXIMUM SIZE © ? digits | Maximum number of 
| | records which file may 
eo : Contéin 
RECORD SIZE 5 digits Number of bytes per 
| | | record : 
RECOFDS PER BLOCK 5 digits Number of records in 
| | each btock 
CREATED | | > cigits — | File creation date 
, (Julian YYDOD) 
ACCESSED 5 digits Last access date 
| | (Julian YYDOD) 
FILE TYPE 8 characters See Note jf 
NO. AREAS | 2 cigits Kumber of areas 
Curréntly attoc- 
ated 
AREA ADDRESSES R digits | see Note 2 
6 hexe characters : 
AREA SIZES 8 digits _ See Note 2 
6 hex. characters 
OVERFLOW NISK 7 


characters Rame of overflow disk 
x Blank if not an 
overflow area 


Note 1: The FILE TYPE will be one of the following: 
DATA — normal data file 
SRCELANG - source language file 
SRCELIBR - source library file 
CODE - object code file, followed by compilation date 
(YYDDD) 
KEY - key file 
SYSTEM -— system file (for example, MCP,interpreters) 


Note 2: For each file the area addresses and sizes of allocated areas will be printed in these columns. For 
areas on an overflow disk the overflow disk name will follow the size. 


‘Output messages: 


MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


TABLE SIZE 3 The number of file- 
EXCEEDED names to be sorted 
| by LR tn an ASCEND- 
ING or A request has 
exceeded the maximum 
permitted (254). 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


input ° Not FOUND Fite specified is Check the correct 
IN DIRECTORY OF not on the disk cisk and reenter 


THIS DISK if neceéssary 


input = NO FILES IN Group of files Check input and 
DIRECTORY FCR specified is not on revrenter if necessary. 
THIS FAMILY disk Check for correct disk- 


Note: Refer to “Common Utility Output Messages” for additional aid. 
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MODIFY (Program Code File Modification) 


This utility allows the changing of a number of file attributes within the file parameter block (FPB) and pro- 
gram attributes within the program parameter block (PPB) of a code file. It should not be used unless the mean- 
ing of each attribute is thoroughly understood. Refer to the CMS MCP manual for more information on FPB 
and PPB formats. 


The utility operates in an interactive manner using a console file if no further information is provided when 


initating the utility, thus: 
MODIFY 


For details of the interactive mode, see later. Specifications can be entered when starting the utility. The name 
of the code file to be modified is preceded by the optional keyword “CODE.FILE”. Following the code file 
name is either the keyword “FILE” to enable file attributes to be modified, or the keyword “PPB” to enable 
program attributes to be changed. The file whose attributes are to be changed is specified by the internal file 
name (i-f-n) as given by the program source code listing. The i-f-n is determined by the programmer. Additional 
keywords are “PRINT.FPB” and ‘““PRINT.PPB” to print the complete FPB and PPB respectively. The complete 
specifications to the utility are terminated by the keyword “END”. 


Format: 


MODIFY | CODE.FILE | disk-name / Pprogram-name 


t 


FILE i-f-n file-attribute value | 
| PRINT.FPB 


END 


PPB ppb-attribute value 
PRINT.PPB 


The commas are optional, but may be used to improve readability. See later for the list of attributes and 
allowable values. | | 


Examples: 
To modify the value of FID (file-id) and change the device kind of a file whose internal name is INFILE 
in a program code file COPY on disk SYS2: _ 
MODIFY CODE.FILE SYS2/CCPY, FILE INFILE FID CARDS DEVICE CR, END 


To change the value of CONTROL.STACK to 50 in code file AR768 on disk AR1, and print the resultant 
PPB: | : 


MODIFY AR1/AR768 CONTROL.STACK 50 PRINT.PPB END 
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interactive Mode 


If no initiating specifications are given, PKs 1 to 6 are lit for various functions. 


modify | modify 
PPB FPB 


Pressing PK1 gives a display of the meanings of the 6 PKs, as shown above, followed by the request 
CODE.FILE? 


Enter the code file name, followed by OCK1. The utility requests 
SELECT FUNCTION 


and lights appropriate PKs. While any relevent PK is lit, the corresponding function can be started. 


If PK2 (modify PPB) or PK3 (FPB) is depressed, the utility requests 
PPB ATTRIBUTE or 
FPB ATTRIBUTE 


Enter the name of the attribute, as given in the table later. The utility displays the current value, then re- 
quests 


NEW VALUE. 
Enter the new value required. The utility then returns to the select-function loop. 


File Attributes 


Table 4-2 gives the keywords for each file attribute that can be changed by the MODIFY utility, together 
with allowable values for each attribute. Table 4-3 gives the keywords of each PPB attribute that can be 
changed, and allowable values for each. | | 


Note that each modification is performed in turn, so that the keywords -PRINT.FPB and PRINT.PPB will 
reflect the FPB and PPB after any modifications specified previously in the message to MODIFY, but before 
any modifications are made that are specified after the print request. 


Output messages: 
MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ATTRIBUTE VALUE Value is either Check current values 
MISSING missna or incorrect». -Ey PRINT.FPS or 


other sodifications FRINT.PPB; then uSe 
carried out. utility for the attr- 
ibute In error. 


KEYWORD IN ERROR Self-explanatory>s, AS abovee 
other modifications 
carried out. 
ATTRIBUTE*VAL The attribute being 
INCONSISTENT assigned cannot take 
the value being 
givens other mod- 
ifications carried 
out 


As abovee 
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A value is being | As above. 
assigned to a value» 

rather than to an 

attributes other mod- 

1fications carried 

out, 


INCORRECT ATTRIBUTE 


DEVICE = MYUSE Incompatible values Use MOCIFY to correct 
INCONSISTENT of these file attri-s either or both of 
| | butes. This is a these fields. 
warning that the 
program may give an 
error when executec. 


FILE“SIZE Too Vatue for FILE.SIZE Check with PRINT.FPB 
LARGE is incorrect.- This  9f necessary and correct 
iS a Warning. | the éttribute. 


Value for NO.BUFFERS As atoye. 
iS incorrect. This is 
a warning. 


TOD MANY RUFFERS 


NOT INTEGRAL 


The buffer size is not Use MOCIFY to correct 


OF SUF. an exact multiple of one or both of these 
the record sizee This ettribtites before 
is a warning. running programe 


CODE FILE NAWE IN self-exptanatory> 
ERROR | all modifications 
are ignorede 


Rewinput 


FILE NAME NOT FOUND The internal fite As above. 
name 1S not in coce 
filer alt modific- 
ations are ignored. 


CURRENCY SYMBOL Self explanatory Re-irput. 


EXPECTED 


Non“numeric char- Check with tables 
acters were input 4.2 enc 4.3 and 
where a numeric re"irout. 

vatue is needed. 3 


NUMERIC ATTRIBUTE 
VAL REQ) 


FILE NOT SPECIFIED 


Re"input . 


Missing keyword 
"FILE" | 


PPB NOT SPECIFIED Missing keyword 


Rewinput.e 


NOT AN INDEXED Attemped to use an Check initial 
FILE incexed-file attri- input to MODIFY 
bute on a non*ind= 
Syed Scr ttdhe 
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NOT A COBOL PROGRAM 
FILE 


NOT AN MPL PROGRAM 
FILE 


file attribute 
name 


MF IO 

FIO 

REEL 
DEVICE 
RECORD 
BUFFER 
FILESI2€ 
NO.BUFFERS 
CYCLE 
FORMS 
SET.UPDATE 
NO-LABEL 
CONDITIQNAL 
SINGLEAREA 
GEN-CHECK 
NO-REWIND 
CLOSEMODE 
CRUNCH 
MERGE 
OTHERUSE 
MYUSE 
EXTEND 
ACCESSMODE 
GEN.NOQ 
LAST.ACCESS 


SAVE 
FILE-)EFAULT 


NON-STANDARD 
D.MF ID 


DeFID 
ROUGH.TABLE 
KEY.LENGTH 


KEY.OF FSET 
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Wrong PPB attribute Re-irput. 
used (see tabte). 


Wrong PPB attribute Fe~input. 
used €see table) 


Table 4—2. File Attributes Accessible by Modify 


allowable values 


1-7 atphanumeric chéracters 

1-12 alphanumeric chéracters 

3 decimal cigits Im range 00€°999 

one of the mnemonics given tn Tabte 4°74 
1-5 decimal digits in range C765535 
1°5 decimal dicits in raérge C*65535 
1-7 decimal digits in range C71048560 
1-2 decimal digits in rarce 1°16 

2 decimal digits in range 00°99 

ON» OFF | 

ON» OFF 

ON» OFF 

ON» OFF 

GN» OFF 

ON» OFF 

ON» OFF 

LOCK» PURGE» REMCVE» RELEASE» HALF .CLOSE 
ON» OFF 

ON» OFF 

FREE» LOCK .ACCESS» LOCKED 

INPUT» QUTPUT, I0 

ON» CFF 

SEQUENTIAL» STREAM» RANDOM 

1-5 decimal digits tn rarge C765535 

> decimat digits tin Julian déte format» 
Yy0o00 7 

1-3 decimal digits in range C-999 
TYPEL thru TYPE2S (see MFL Reference 
Manual ) 

ON» OFF 

im? alphanumeric chéracters Cindexed 
fites onty) 

1-12 atphanumeric chéracters Cindexed 
files onty) 

1-5 decimat digits tin range C7*65535 
(indexed files orty) 

1-2 decimal digits in range 1728 
Cindexed files only) 

i-5 cecimal digits in range C°65535 


Cindexed fites onty) 


Table 4-3. PPB Attributes Accessible by Modify _ 


PPB attribute | allowable vatues 
name | 


INTERP.PACK | | l-/ alchanunmeric characters 
INTERP.NAME 1°12 alphanumeric characters 
CLASS Aw Bs C 


EQJ~.SUPPRESS ON» OFF 
DATA.STACK 1-5 decimat digits in ranse 0°65535 
C(MPL/BIL programs only) 
CONTROL.STACK 175 cecimal cdigits in rance 90°*65535 
CURRENCY.~SYMBCL one character (CCBOL/RFG programs 
: only) 


Table 4—4. Mnemonics for Device Attribute for Modify 


mnemonics meaning 


any printer 

keyboard printer 

keyboard display 

keyDoard any outpvt 

serial prirter 

line printer 

any cafrc reéacer 

any card punch 

any card reader/Curch 

8O0-column Card reacer 

BOecolumn card punch 

8O0™coltumn card reacer/ounch 

96e-colunrn card reader 

96°cofumn card pturch 

96-column Card réeader/nunch 

Paper tape reader 

paper tape ounch 

Magnetic tape reel or cassette 
magnetic tape reet : 

Magnetic tape casSette 

magnetic tape reet without write permit 

magnetic tade cassette without write permit 

any cisk 
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PD (Print Disk Directory) 


(a function of SYS-"SUPERUTL) 


This utility allows the operator to verify the presence on disk of a particular file or a group of files. 


file-name or 
PD | disk-name / group-name 


Format: 


Examples: 


To find out if a particular file is on disk: 
PD PR210 
PD PR2/PR020 


To find out if a group of files is on disk: 
PD PR2/PRO= 
PD PR3= 


To find out if several different files or groups are on disk: 
PD PR3= , PR2= 
PD GL2GLO= , GL2/GL30= , GL250 


To inquire about all files on disk: 


PD PR2/= 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ON LINE program= File found or disk None. 
name if single file req- 
uestedcd. 


group*name ON disk- Group of files found 
name CONTAINS: on disk 


NOT ON LINE File not found or Check input (re-input 
program™name | disk 1f necessary)» 
Check for correct 
cisk. 


NO FILES FOUND IN Group not found on Check input (Crecrinput 
THE FAMILY “group” diske if necéssary) » 

|name”"™ Check for correct 

cCisk. 
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POSSIBLE CAUSES @ 


Successful End of 
Jobe . 


"file"name™ REQUIRES Remainder of specif- supply appropriate 


OVERFLOW DISK "disk ied file resides on Cisk. 
name" another disk. Pp 
| | Cannot comptete untit 
appropriate disk is 
suoplied. 


Note: See “Common Utility Output Messages” for additional aid. 
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PL (Print Log Files): 


This utility allows the operator to list the contents of log-files present during any one particular session. 


Format: 


SYSTEM or S 
ERROR or E 


FROM date | time VF 
PL filename TO date time Vy 


ENTRY number 
MIX number 
INPUT 
OUTPUT 


The option “SYSTEM” (or ‘‘S”) is specified to list only system messages from the log-file. 
The option “ERROR” (or “‘E’’) is specified to list only error messages. 


The option “FROM MM/DD/YY HH/MM/SS” is used to list the logged message from the specified date and 


time. If time is not specified, then 00/00/00 is assumed. MM = month, DD = day, YY = year, HH = hour, 
MM = minute, SS = second. 


The option “TO MM/DD/YY HH/MM/SS” is used to list the messages up to that date and time. If time 
is not specified, then 00/00/00 is assumed. 


If the option “ENTRY” is used, the utility will print starting from the record number specified by the 
operator. 


The “MIX number” option is used to print all messages related to specified mix (number(s)). 
The “INPUT” and “OUTPUT” option allows the operator to print either input or output messages. 


Certain “defaults” are as follows: 
SYSTEM and ERROR messages; 
INPUT and OUTPUT messages; 
FROM 00/00/00 00:00:00; 

TO last date and time in log; 
ENTRY 1. 


All entries are displayed irrespective of their mix numbers. Any of these defaults can be reset at run time. 
If no real-time clock was available when the file was created, then no check will be made on the “time” portion 
of the operator input, and “‘N/A”’ will be printed under the “TIME” heading on the report. 


Entries with multiple records will only have the record number and record contents displayed; all other col- 
umns will be blank since the contents of these records will all be of the same type, and created at the same 
time. 


Only entries which conform with either the defaults, or operator input peso nons will be displayed, all oth- 
ers will be ignored. | 


The range of values for ENTRY and MIX numbers are 1-65535 and 1-254 respectively. Checks at run-time 
are made on the values entered and messages issued if they are in error. 
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Examples: 


To print the contents of the log-file called SYS-LOG-HOLD: 
PL SYS-LOG-HOLD 


To print the error messages logged in the log-file called SYS-LOG-01: 
PL SYS-LOG-01 ERROR | 


To print entries in SYS-LOG-HOLD file from record 100, related to mix number 12 from January 1, 1979 
until latest date: _ 7 


PL SYS-LOG-HOLD ENTRY 100 MIX 12 FROM 01/01/79 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


NO FILE NAME IN *<file"name> option Check contents of 
PARAM.FILE © WaS uSed. The utility "Starfilte™ Cuse 
filename | failed to find a LIST) and recreate 
file-name within the if necessary’ re- 
first 5, 80-pbyte input. 
records of the fite>» 2 
ot Ceimane 7? 


NO FILE NAME FOUND One of the options Re~enter>» 
IN PARAMETERS : 1S Specified first. first. 


with file-neme 


ILLEGAL OPTION. The option specified Check input ard 
texte | was not recognised. reenter. 


ILLEGAL VALUE , "number™ after either Check input and 
number. ENTRY or MIX is not remerter. | 
Within the attlowable 

range of numbers. 


ILLEGAL NUMBER OF | *<filename> option was Check contents of 
RECORDS IN FILE used. “filename” file "Starfite™ Cuse 
filename | haS more than 5» 8¢c- LIST) and recreate 
byte records. 1f necessary. 


JILLEGAL PARAMETER Input after a special Check input ara 
text | entry ts incorrect» reenter. 

or inapororriates 

that tse "ENTRY 

number™. If "number" 

was not recognizable» 

this would produce 
the error). | 


INO TIME SPECIFICATION Input after either Check input ana 

AFTER time option "TO" or "FROM" is reenter. 
incorrect or inapp- | 

ropriate. | 
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POSSIBLE CAUSES SUGGESTED ACTION 


A number after a Check input and 
special entry (that rementeér. 

is» after MIX) was 

expected but not 

found). 


One part of the Check input and 
ALREADY SET operator input revmerter. 
message contradicts 
the other (that 15>» 
"INPUT" and "OUTPUT 
specified simultén- 
eous ly). 


ILLEGAL TIME "time specification" Check input ara 
SPECIFICATION format tncorrect reenter. 

time specification (that is» “time” 

was typed before 

“date” if both are 

usede 


PL unable to use a Verify (with PD) 

FILE required file. CEX: that file is on disks 
in use by some other if file 1s on correct 
program). : cisk»s wait until progra 

using file goes to 

ECJ anc then retry 

PL. 


NO ENTRIES FROM wWENTRY™ option was Check input ard 
ENTRY NUMBER used and nothing reenter . 
number eatuivalent to spec- 

ified “numder™ was 

found in file. 

Note: This option witt 

start the processing 

at the first value it 

finds which is the 

Sarre as that given. 

If the “match” fails» 

this message displayed. 


filename IS NOT Specified file is not Creck input ard rerenter 
A LOG FILE of *tog~file™ format. if necessary. 


ILLEGAL FILE "filename™ does not Check input ard 

NAME filename conform to standard re-enter if necessay- 
CMS format (that 1s» 
disk name might Le 
toc long). 
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MESSAGE 


NO ENTRIES FOUND 
WITHIN PARAMFETERS 


PARITY ERROR IN 
READ OF FILE 
filename 
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Iintede 


POSSIBLE CAUSES SUGGESTED ACTION 


During processinc» Check input and 
End of File is re"enter if necessary. 
reached and no en | | 

tries have been er- 


(Record number at 
which error occurr- 
ed prints immecdiate- 
ty after messace). 
Program encountered 
error on trying to 
read specified file. 
WARNINGS 

Program normally att- 
empts to continue 
processing. Howe€ver» 
if ENTRY option bas 
been used and error 
occurs white proc- 
essing this comménd» 
the results might rot 
be those rennested. 


RM (Remove Files from Disk) 


(a function of SYS-SUPERUTL) 


This utility allows the removal of individual files and groups of files from disk. The disk areas associated with 
those files are returned to the available table. 


If the utility detects that a keyfile is to be removed and the <BOTH> option has been specified, then it 
will remove both the keyfile and the associated data file if both are on disk. If <BOTH® is not specified then 
only the keyfile will be removed. 


Format: 
file-name or 
RM disk-name / group-name < BOTH > 
Examples: 
p _ oa 
To remove a single file: an ses, Ad, 
RM AR300 ; ee gf fue 
RM PR1/PR300 yew ( 


To remove a group of files: 
RM AR= 
RM INDISK2/IN3= 


To remove several different groups and/or individual files: 
RM 1C230, IN076, INDISK1/IN2= 


To remove a keyfile and associated data file: 
RM PR200K <BOTH> 


A request for the removal of a system file will cause the utility to output the following: 
filename IS A SYSTEM FILE 
AX “mix number”/RM ACPT 


Then, to remove a system file: 


AX mix-number/RM file-name OK (mix-number is the mix number of RM). 


If the operator types any other sequence the system file will not be removed. 


Example: 


RM NDL= 

NDL.INTERP IS A SYSTEM FILE 
12/RM ACPT 

AX 12/RM NDL.INTERP OK 
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Output messages: 


SUGGESTED ACTION 


POSSIBLE CAUSES 


"fitename™ REMOVED | File was removed. None. 


“filename” NOT REM- Specified file Check input Cretinput 
OVED NOT FOUND was not removed. if necessary); 

Check for correct 
Cisk. 


"filename” NOT specified file was hait untit file is no 
REMOVED * IN USE not removed because longer in use» then 
it 31s Currently re“input.e 
being uSed by the 
system. 
“filename” NOT Specified file was If file is to be 
REMOVED =- SYSTEM not refioved because removecs tyoe 
FILE it is a "system file "AX fix"number/RM 
Cfor examples MCP» | file-néeme OK". 
an interpreter» etc). If file 1s not to be 
| 7 removed» tyne AX 


hix/RM NO 


None. 


JINDEXED PAIR Keyftle and associat- 
"file name™ "“file- ed data file were 
name“ REMOVED | removed. 


INDEXED PAIR Keyfile and associat~ Check input Cre-input 


“filename” ec data file were not tf necessary) 

“filename” NOT removed» This message or 

REMOVED is fotlowed by the Check for correct 
reasone cisk. 


INDEXED PAIR Specified keyfile ang Wait until files are 
"“filenane” data file were not no lcncer in uses ther 


"filename” NOT | removed because at rerirput. 
REMOVED * IN © least one is current” 
USE ly being used by the 


SyYStem. 
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SO (Squash Disk) 


When a disk unit is used extensively with a high degree of file activity involving creation and removal of files 
then it is possible for the available space on the disk to become so fragmented that it is increasingly difficult 
to find enough space in one single area to satisfy requests for disk space. This results in a degradation of system 
throughput with an increasing incidence of ““NO USER DISK’”’ failures and extra time needed to search through 
available areas. This situation 1s known as “checkerboarding”’ of the disk. In the extreme case each area of 
disk in use is separated by an available area, as shown in the diagram below: 


The SQ utility is designed to eliminate checkerboarding of disk, either for the whole disk or part of the disk. 
This process is called ‘‘squashing” disk and is accomplished by moving each data area in turn to the first avail- 
able area at a lower address. If an entire disk is squashed then all available areas are merged into one area 
at high-address end of the disk, as in the next diagram: 


The options available within the SQ utility are: 


Squash of a complete disk. 


All data areas are moved to successively lower addresses until only one available area is left (as in diagram 
above). 


Partial squash 


Only data areas within a default section of the disk are moved to lower addresses within the section. 


Fast squash 


The aim of a fast squash is to create an available area of disk of a requested size. Only those data areas 
are moved which will allow an available area of a sufficient size to be created. 


Economic squash 


In this case, data areas are only moved if the gain in terms of available space justifies the time spent in move- 
ment of the data area. As an example, consider the following case: 
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where data area #1 is 100 units, data area #2 is 200 units and both available areas are 1 unit each. If available 
areas are merged the available area gained would be 2 units. However, to acquire these 2 units, the 200 units 
of data area #2 would have to be moved. Therefore an ‘economic squash” would not move data area #2. 
In general terms, an economic squash will ignore small available areas that are interspersed in large data 
areas. However, in some cases an economic squash will have the same effects as a full squash. 


With all options of SQ a further option is available to print a map of the entire disk in disk-address order 
both before and after squashing action. 3 


Input is as follows: 


Format: 
VERIFY 
ALL 
FAST number 
SQ disk-name 
. BEGIN END o 
FROM start-address TO end-address 


| LIST | 


note: the number is in the range 1 to 65535; the start-address and end-address are 6-digit hexadecimal disk 
addresses, for example, O00AB3, 01A375. 


Examples: 


To perform an economic squash of disk PR2: 
SQ PR2 


To check the integrity of disk PR2: 
SQ PR2 VERIFY 


To perform a full squash of disk PR2 and list the disk map: 
SQ PR2 ALL LIST | | 


To move data areas to provide one available area of 1000 sectors on disk PR2: 
SQ PR2 FAST 1000 | 


To perform a partial squash on sectors 0 through 512 of disk PR2: 
SQ PR2 FROM BEGIN TO 000200 | 
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To perform a partial squash on sectors 512 through 4096 of disk PR2: 
AQ PR2 FROM 000200 to 001000 


To perform a partial squash on sectors 4096 to the last addressable sector of disk PR2: 
SQ PR2 FROM 001000 TO END 


Before performing any function which involves physically moving data areas, the integrity of the disk is 
checked. Integrity checking involves analyzing disk assignment to verify that the entire area of the disk is de- 
scribed in the file directories and available table, checking the directories themselves and attempting to resolve 
anomalies (for example, missing areas or overlapping areas). Only after the integrity ts verified are areas of 
disk physically moved. 


Certain areas of disk will not be moved in any circumstance. These are areas of disk currently marked as 
in use, and any system log files. In addition, SO can only be run in a suitable mix, as defined by the MCP 
to safeguard the integrity of the disk. No user program can be run with SQ. During execution of SQ the MCP 
will reject any attempt to execute any utility or user program. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


LARGEST AVAILABLE Given on successful None. 
AREA IS number comoletiton of SQ. 

SECTORS. TOTAL 

AVAILABLE IS number 

SECTORS IN number 

AREAC 5S). *x*«S9 

COMPLETED*** 


NONTFILE DIRECTORY Disolay during ver= Fun S@ with VERIFY 
FULL - “PARTIAL"™ ification phase if LIST optionse Examine 
SQUASH REQUIRED there are no free tre c1i1sk map to discover 


entries when att”? @é section of the disk 
emoting to add ero that can be squashed 
tries to the avait~ to create free entries 
able table if miss- in the avaitable table 
ing areas are detec- Example: 
ted. The pattern 
. File Area 
: Available 


File Area 

Available 
if squashed will create 
cne free entry in the 
éyailable table. In 
ceneral the # of free 
entries to be created 
equals the # of missing 
éreas that are not con” 
tigucus with any avait- 
able dread. 


SQ INVALID = NO Selfrexplanatory Reirput- 
INITIATUNG MESSAGE 
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POSSIBLE CAUSES | SUGGESTED ACTION 


Pack~id specified 
1s longer than 7 
cheracters- | 


ISQ INVALIO = INVALIO 


Re~input. 
PACK =ID | 


S@ INVALID - | Selfrtexplanatory | Re-input- 
INVALID SYNTAX 7 


SQ INVALID = INTEGER The maximum # of 

MUST NOT BE GREATER. Sectors requested 
THAN 65535 for the FAST option. 
is 65535. 


Re-input. 


S@ INVALID = INVALIO No address or an Re~irput. 
ADDRESS tnvalid address (for 

example» 004615) was 

specified for the 

FROM or TO address 

with partial squash. 


*** BAD SECTOR AND Area marked in S<@ cénnot resolve this. 
filename OVERLAP - avaitable table as Intecrity of file is 

NO WAY TO SEPARATE "bad” overtaps with Suspect. Remove the file 
THEM. SAVE AND/OR area aitocated to | after copying it to 
PURGE AND AT LEAST file. another disk for exam- 
RETURN S€ VERIFY | ination if necessary 

and rur SQ VERIFY, 


x*x* file-name AND Area allocated to file The two areas cannot 


|fitlernamne OVERLAP =~ overlaps with area be s€pérated. Copy 
THERE IS NO WAY T9 allocated to another each file individuatt y 
SEPARATE THE. file. | to arother disk for 
SAVE ONE OR BOTH» | later €xamination if 
PURGE AND AT LEAST | required» remove them 


|RERUN SQ VERIFY | Eoth»s rerun SC VERIFY 


SQ ABORTED - Request was made with None. 
REQUESTED AREA | FAST option for an | 
ALREADY EXISTS : avaitabile area which 

already exists. 


#** SQ ABORTED - Disk labet is probably Oisk must be assumec 
INVALID DOISK ALLOAC. corrupted. useless and should be 
UNIT = 0 | | re“initiatizec. 


kee DOTRECTORY FID Name of file in file Enter "CH <FILE=ID> 
NEG HEADER FID FOR directory name list 16 <FILE*ID> to correct 
FILE filename. does not match disk the énomoly Cthis 
CORRECT USING CH | file header. The rewrites the disk file 
AND FESTART SQ filename displayed header). 

| is that in the name 
List. 
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SQ INVALID - Setfr-exotlanatory. Make disk present and 
SPECIFIED DISK NOT rerun SQs check input. 


AVAILABLE 


*x* SQ ABORTED A partiat squash was 
NOTHING TO SGUASH requested and S@ 


IN THAT AREA found nothing to do 
| in that section. 


SQ ABORTED ~- NO WAY Area size specified Attempt to remove 
TQ GET REQUIRED in the FAST option unwanted user files: 
AREA cannot be obtained rerirput SQ. 


either because it 
1S Larger than the 
total avaitable 
space or because 
certain areas cannot 
be moved to retease 
available space. 
For example: 
Area # 1 100 urits 
Available # 1 100C 
units 
Area # 2 100 units 
Available # 1 cannot 
be used if areas # 1 
ang # 2 are iIntuse or 
system tog files 
Decause areas # 1 anda 
# 2 cannot then be 
moved. 


kexe*x MEMORY IANCONS= Internat work-tables Rerur SQ VERIFY. 
ISTENCY CR SOME in memory Cused by S€) croblem persists » 
OTHER IRRECOVERABLE are corrupted. requést technical 
PROBLEMS = RERUN SG essistance. 


If 


xxx ADDRESS MISMATCH Some addresses in cisk Try to dump or cory 
- SAVE AND REINITIATE directory are probabty files from the disk. 


talizec before retuse. 


zx«x IRRECOVERABLE 1S corrupt. Try to dump or copy 
ERROR ON OISK ©» SAVE files from the disk. 
AND/OR REINITIALIZE Cisk must be reitnite 


lalized before retuSe. 


xxk*e TOO MANY FILES Self-eexplanatory. Save required files from 
OPEN AND/OR BAD AREAS Cisk» then reinitialize 

| = NO WAY TQ SQUASH the cisk. 

‘THE OL SK 
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ESS POSSIBLE CAUSES ‘SUGGESTED ACTION 
wee DISK INTEGRITY SQ has detected anc Scrutinise disk map» 


SUSPECT = USAGE MAP resolved an overlap request technical 

OF THE OITSK WILL BE Situation’ but disk assistance. 

PRINTED CIF LIST IS remains suspect. 

NOY SET) . | | 
wee AREAS STILL A FAST squash has SQ VERIFY wittl return 
MISSING = RERUN detected that areas missing areas to the 


1SQ VERIFY of disk are not évailatle table. 
| accounted for, | 


tee LAST SQ System crash occurr®? Remove suspect file. 
EXECUTION WAS ABNOR= ed while file areas 

MALLY TERMINATED WHEN was being moved. 

MOVING FILE = file=- 

name-INTEGRITY OF FILE 

SUSPECT. EXECUTION 
CONTINUES | 


ieee SQ ABORTED = I/O Hard error on disk If address is outsice 
ERROR AT DISK ADDRESS persists after 10 cirectory areas» remove 
QaNNNNNNQ retries. offerding area with 

xO utility. 


kee [T/0 ERROR ON Hard disk error 
file-name FILE encountered. File 
SKIPPED = EXECUTION is not moved. 

CONTINUES. 


tee WRITE ERROR IN Hard error encount7 Available area is teft 
INEW LOCATION WHEN ered when moving file as availale and shoulc 
MOVING FILE AREA. area to avaitable te XCeed after squash 
DISK ADORESS = area. 7 EQJ-. 

A@NNNNNNGQ. THIS 

AREA SKIPPED = 
EXECUTION CONTINUING 


NOTE | 
Error messages marked with ‘‘***” indicate that a hardware or system software er- 
ror has occurred or that the disk itself is suspect. If these persist, request technical 
assistance. 


General Guidelines 


If the information contained on a disk is important always ensure that backup exists before attempting to 
squash it. 


Always run “SQ VERIFY” before running an actual squash. This will give an indication of the state of the 
disk. 7 


Do not allow disks to become too fragmented before squashing them. A full squash can be a lengthy process 
and can be avoided by running “SQ VERIFY” on a regular basis and running partial squash when the disk 
Starts checker-boarding. 


“SQ VERIFY” is a means of checking the integrity of any disk and if run on a regular basis may help pin- 
point sooner rather than later any degradation in hardware performance or system software bugs. For disks that 
are in constant use “SQ VERIFY” should be run immediately after the first clear start of the day. This can 
help prevent catastrophic losses of information. | 
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TAPELR (List Library Tape Directory) 


This utility allows the operator to print detailed information about the library tape files. Output will appear 
either on the line printer or the console printer. | 


Tapes about which information is required are identified by “library-tape-name”. More than one tape name 
may be requested during a single run of TAPELR. 


Format: 


TAPELR library-tape-name 


Examples: 


To print detailed information about the files on a tape called PRTAPE: 
TAPELR PRTAPE 


To print detailed information about the files on tapes called PRTAPE and ICTAPE: 
TAPELR PRTAPE ICTAPE 


Output format: 


Eight columns of information will appear for each library tape indicated. The column headings, the format 
of the “values” these columns contain, and the significance of these ‘“‘values” is as follows: 


HEADING VALUE SIGNIFICANCE 

FILE NAME i2 character File name 

ACTUAL SIZE 7 dicits Number of recorcs in this file 

MAXIMUM SIZE ? digits Maximum # of records this file 
may Contéin. 

RECORD SIZE > digits # of characters in each record 

RECS/BLOCK 5 digits # of records in each block 

CREATED 5 digits Date file was createc (Julian 
YYDDD) 

ACCESSED 5 dicits Date file was tast accessed 

| by a procram (Julian YYODD) 
FILE TYPE 8 cheracters See Note below 


Note: FILE TYPE will be one of the following: 
DATA -— normal data file 
CODE - object program file 
KEY - key file 
SYSTEM - system file (for example, MCP,interpreters) 
SRCELANG - source language file 
SRCELIBR - source library file 
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Output messages: 


MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


library=tape-name This tape was not 
NOT A RECOGNI7ED createc by either 
DUMP TAPE DUMP or UNLOAD 
| functions of LD 
utility. It its 
ignored by the 
TAPELR utility. 


Note: Refer to “Common Utility Output Messages’’ for additional messages. 


TAPEPD (Print Name of a Library Tape) 


This utility allows the operator to print the names of files found on a library-tape. More than one tape name 
may be requested during a single run of TAPEPD. 


Format: 


TAPEPD library-tape-name_. 


Examples: 


To print the names of files found on a tape called PRTAPE: 
TAPEPD PRTAPE 


To print the names of the files found on tapes called PRTAPE, ICT APE, and GLTAPE: 
TAPEPD PRTAPE ICTAPE GLTAPE 


Output format: 


For each tape requested, the following information is displayed: 
MT library-tape-name DUMPED ON day of week DD month YY contains: 


This message precedes the names of files found on each tape. The list itself contains 3 files per line. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


library=tape-name This tape was not 

NOT A RECOGNIZED createco by either 

DUMP TAPE the DUMP or UNLOAD 
function of LOD 
utitity. It 1s 
lanored by the 
TAPEPD utility. 


Note: Refer to “Common Utility Output Messages” for additional messages. 
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TL (Transfer Log Files) 


If logging is enabled following any warmstart, a number of “‘log-files” are in use. The purpose of these files 
is to maintain a record of all input/output mesaees that appear on the SPO within this given period of time. 


In order to ered easy access to all the files, they are consolidated into one large file. This is done through 
the use of the TL utility. 


Format: | 
TL | disk-name / | file-name | | RECOVER 


‘“‘File-name’”’ is the name the user wishes the consolidated file to be called. 


In order to permit a correct consolidation, there may be NO other programs running at the time when TL 


is initiated. 


The utility will determine the number of files to be consolidated and also the size of the consolidated file. 
It will then transfer each “ready-to-transfer” , closing the consolidated file after each log-file has been trans- 
ferred, until it reaches the file which was in an “‘active ‘” state at time of execution of TL. 


If the “RECOVER” option has been specified, then the utility will enter the ‘‘active”’ log file when it reaches 
it and it is not in use, and transfer all entries up to the latest. If the ‘“‘active” file is in use then the utility 


displays “ILLEGAL USE OF RECOVER PARAMETER, ACTIVE FILE NOT CONSOLIDATED”, and will. 


consolidate only the “ready-to-transfer’’ files. 


If the “RECOVER” option has not been specified, consolidation will end when the “active” file is reached. 


All log-files transferred will be left in a “‘transferred”’ state. 


Examples: 


To transfer all “ready-to-transfer” SYS-LOG files to LOGHOLD: 
TL LOGHOLD 


To transfer all “‘ready-to-transfer’ SYS-LOG files to LOGHOLD on the disk called ARDISK1: 
TL ARDISK1/LOGHOLD 


Output messages: 
IMESSAGE oo RPOSSTBLE CAUSES SUGGESTED ACTION 


ILLEGAL FILENAME Specified fite- Check input and 
filte"name nNamre contains too re~input. 

: | many characters- | 

UNABLE TOC OFEN Utitity cannot Check with KA on 
TRANSFER FILE “create” a con- evailable space: use 


filename soltidated fite KM if recessary and 
with the name re“inpute Check drive 
requested (for. fediae 
exemple» no disk 
Spaces no disk 
media). 
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MESSAGE ; a POSSIBLE CAUSES | SUGGESTED ACTION 


NO PARAMS. IN *<filecname> option Check on contents of 


PARAM.FILE was used and TL could "starfile” Cuse LIST) 
file°name not find anything in and fecreate if nec* 
the first 5» 80-LEyte essary: recrinpute 


records of the file» 
"filername”. The 
utitity wilt expect 
"file“name” to te 
within this file area. 
lf found» this “file 
name“ wilt be used 4s 
the nawre of the cons- 
olidated fite. 


NO SYS*LOG°FILES Utility» on attempting 
FOUND to determine the nurnber 
anc sizes of logfiles 
to be transferreds wés 
unable to find ary log- 
file of the form "SYS°* 
LOG"*NN” ("NN has vatues 
between O1 and 16). 


UNABLE TO OPEN *<file-name> option Check on contents of 
FILE filename was used and TL could “starfile”™ Cuse LIST) 
not fine anything in and recreate if necesso 
the first 5» 80-rbyte ery? if rerinput. 
records of the file» 
"file-name™. The utile- 
ity will expect "*fites> 
name” to be within 
this file area. If 
founds this “filename 
will be used as the 
name of the consol" 
idated file. 


ILLEGAL NUMBER OF *<file-name> option Check on contents of 
RECORDS IN FILE was used and more than “starfile"™ Cuse 
file-name S» BO0-byte records in LIST) énd recreate if 
the file» "“file"nare™. necessary; rectinput. 


NO READY=TO-TRANSFER No log-files in either 
FILES FOUND an “active” or "ready- 
to-transfer” state 
were founde No consol 
idation wilt occur. 


NO ACTIVE LOG 
FILE FOUND 


No file in the “act? 
ive” state was found. 
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| MESSAGE 


TRANSFER COMPLETED 


PARITY ERROR IN READ 
OF FILE fitlecname 

or 
PARITY ERROR ON WRITE 
TO FILE file-name 


NO FILE NAME FOUND 
IN PARAMETERS 
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POSSIBLE CAUSES 


TL successful End of 
Job. | 


Reed or write parity 
errors found for 

specified files. The 
record number at 

which error occurr- 
ed will be displayed- 
If utility continues 


ProcesSing» then the 


message “CONTINUING 
PROCESS*™ wilt display. 


Otherwise TL wilt go 


to End of Job anc 
teave partiaily Con- 
solidated file» ce- 
pending on where 
error occurred. 


The "RECOVER™ option 


was used anda file 


name was not given. 


SUGGESTED ACTION 


None 


Correct the input 
and reenter. 


‘UNLOAD (Unload Files from Disk to Library Tape) 


This function, a part of the utility LD, allows the operator to copy files from disk to a library tape. The 
files will be deleted from the disk after they have been copied to the tape. 


Format: 


| LD UNLOAD TO library-tape-name | FROM disk-name 
file-name or | V 
group-name < BOTH> 


If the <BOTH> option is used immediately after a request to dump a keyfile, the associated data file will 
also be dumped, provided it resides on disk. 


Examples: 


To dump all files from disk beginning with the letters, “PR” to a tape called PRTAPE; and then remove 
them from disk: 
| UNLOAD TO PRTAPE PR= 
To dump the keyfile called AR200K and its data file from a disk called APBU to a tape called ARTAPE, 
removing them from disk after dumping: 
UNLOAD TO APTAPE FROM APBU AP200K <BOTH> 
To dump from the system disk files called AP020, AP030, and APTASK to a tape called APTAPE; removing 
them from disk after dumping: 
LD UNLOAD TO ARTAPE AP020 AP030 APTASK 


Since “UNLOAD” is a part of the utility LD, “LD” is actually what will appear in a mix message. To discon- 
tinue the UNLOAD function, DS mix-number/LD must be used. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


INO FILES IN THE 


Specified group Check input? recinput . 
FAMILY group-name was not found on if necessary. 
ON OISK disk*name this disk. Check for correct 
FOR UNLOAD Cisk. 


NO FILE file-name Specified file was Check input and re~input 
ON DISK disk-name not found on this if necessary. 

FOR UNLOAD disk. Check for correct 
| | Cisk. 


filename NOT Specified file Wait until the file 
DUMPED - IN QUTPUT cannot be dumped is not tn use ano then 
USE DUMP ABANDONED as it is ir uSe. reterter the UNLGAD 

- TAPE BEING If *"ABANDONED”™ message messége for allt files. 
/PURGED is givens tape 15 
purged and UNLOAD 
goes to £EQJ. 
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POSSIBLE CAUSES SUGGESTED ACTION 


file-name NOT DUMPED Specified file was 


- HAS BEEN REMOVED. removed between 
DUMP ABANDONED = the start of UNLCAD 
TAPE BEING PURGED anc the time when: 


it was to be dumped 
to tape. File cannot 
be dumped. Tape is 
purged an UNLOAD 
goes to EJ. 


filesname NOT DUMPED Contents of specifiec Check input and 
= HAS BEEN ALTEREC> file were changed reenter if necessary. 
DUMP ABANDOND = between the start 

TAPE BEING PURGED. af UNLOAD and the 

time when it was 

to be dumped to 

tapee Fite cannot 

be dumped. 


filertname LOAD/OUMF End of file has teen 

DISCREPANCY reached before 
expected. Implies 
erroneous Disk File 

Header. | 


filename NOT DUMPED <BOTH> option was If specified data file 
- DATA FILE NOT ON specified» but déta Cump is required» supply 
LINE | file was not found utility with backup 

on diske copy of file if exists. 


DUPLICATE file-name More than one recuest 
ALREADY BEING DUMPED was made to UNLOAD 
Same file. 


UNLNAD success ful} 
original file on disk 
Was removed. 


file-name REMOVED 


UNLOAD successful. 


filename DUMPED 


Note: Refer to “Common Utility Output Messages” for additional messages. 
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UPDATE (Disk File Update) 


This utility allows the operator to construct new disk files from existing files. “CREATE” and “AMEND” 


use many similar features. 
| A . number | 
N 


Format: 


UPDATE | disk-name / file-name 


FILESIZE number 
TO new-file-name CRUNCH 


The existing file must be a source or data file. Attributes such as Record Size will be taken from this file 
and used for the “‘new’’ file. 


Input may be specified as “A” (alphanumeric) or “N’’ (hexadecimal). (see CREATE utility for details). 


The “number” option may be used to set “tab” positions for character input. (see CREATE utility for de- 
tails). 


The maximum number of records likely to be written to the new file may be specified using the FILESIZE 
option. If no total number of records is specified, the number will be taken from the old file. 


The CRUNCH option allows the operator to specify that the new file should occupy the minimum area of 
disk, but never be extended. , 


The utility operates in three modes: ‘Record Modify” (PK2), ‘Record Select” (PK3) or ‘Record Insert” 
(PK4). 


write 


tast & 
get 
next 


PK1 is used to write the last record processed to the new file and then select and print the next logical record 
from the old file. The printout will show the record number in the old file of the selected record, together with 
the next record number to be written to the new file. 

PKS is used to delete the last record printed by selecting and printing the next logical record from the old 
file without writing the last record to the new file. The printout will show the record numbers in the old file 
of the selected record, together with the next record number to be written to the new file. 


If PK3 is used, the required record is identified by logical record numbers using this format 


| RECORD number 
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The “number” cannot be less than the last record obtained from the old file, or greater than the number 
of records in the file. During the process of locating the required record, all records from and including the | 
last record processed, up to the one immediately prior to the selected record, will be copied from the existing 
file to the new file. When found the selected record will be printed, with its record number in th old file fol- 
lowed by the record number that the next record written to the new file will take. “Record Modify” (PK2) 
or “Record Insert” (PK4) may then be selected. Note that a record inserted by Record Insert mode will be 
positioned after the selected record in the new file. Selecting Record “0” allows records to be inserted before 
Record | of the old file. 


PKZ is used to make alterations to existing records. This PK operates as PK2 in the CREATE utility (see 
CREATE for details). 


PK4 allows the operator to insert additional records in the new file after the last selected record of the old 
file. Input may be made in accordance with the specified tab stops. The utility prints the record number in the 
old file of the last record taken from the old file, and the record number in the new file, of the next record 
to be output, prior to accepting keyboard input. When all insertions have been made at a particular point in 
the file, an available PK may be pressed to select the next mode or terminate the utility. NOTE: to insert a | 
record at the beginning of the new file, Record “0” should be selected in Record Select Mode, prior to Selecting 
Record Insert Mode. 


Examples: 


To update a source file called ““APFILE” of record size 40 bytes into a file called ““APFILE2”. 
UPDATE APFILE 5 10 15 20 TO APFILE2 


The utility will illuminate PK1 and PK6. By pressing PK1, next sequental record will be selected and printed. @ 


As the utility is already in the Record Select Mode, by typing a record number, the specified record number 
and its contents are printed. 


4 4 ABCDEFGHIJKLMNOPORST 


Note that the first “4” is the sequence number in the old ‘“‘APFLE” and the second “4” is the sequence num- 
ber in the ‘“APFILE2’’ file. 


At this point the following PKs are available for selection: 
PK1 — select next sequential record and print 
PK2 - modify the selected record 
PK4 - insert new record after selected record (that is, ‘‘4’’) 
PKS — delete the last selected record by selecting next record 
PK6 — terminate the utility 


To replace characters within a selected record, press PK2 and type the replacement 
D:ZZZZ: OCK1 


resulting in 
4 4 ABCD ZZZZIJKLMNOPORST | 


To insert characters within a selected record, type 
“Y Z:XXXXXX: OCK2 


resulting in 


4 4 ABCDZXXXXXXKZZZOPOQRST 
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To insert a record after record 7 of the existing file, press PK3 (Record Select Mode) and type a record num- 
ber. 


7 OCKI1 


Note: At this point the record selection number given cannot be less than the last selected record, for exam- 
ple, records from 1 through 3 cannot be selected). 


Press PK4 (Record Insert Mode) and utility will print last selected record number on left and next record 
number after that and allows operator to key in record to be inserted. 


7 8 AAAAAA 


The record inserted will have a sequence number of ‘8’ in the file ““APFILE” and will contain “AAAAAA”. 


Output messages: 


Refer to the section on the “CREATE” utility for output messages. 
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XD (Delete Bad Disk Sectors) | 


This utility allows the disk directory to be marked such that selected portions of the disk will not be used. 
The utility will normally be used after recurrent errors of the message : 


DK...ERROR © 


where the dots indicate further information. Refer to section 7, MCP output messages, for the following num- 
bered messages: | | 


2 PARITY ERROR 

3 TIMEOUT ERROR 

4 ADDRESS ERROR 

45 PARITY ERROR (fatal to program) 
46 TIMEOUT ERROR (fatal to program) 
47 ADDRESS ERROR (fatal to program) 


The further information will indicate the disk address at which the failure occurred 


The utility is initiated as follows: 


Format: 


XD disk-name address length 


The disk-name is the disk-id of the disk from which sectors are to be deleted. The area to be deleted is given 
in hexadecimal by the starting address and length. @ 


Example: 


To delete sixty-four sectors starting from hex 395F from disk PR2B: 
XD PR2B 395F 40 
NOTE 
The specified sectors must not be in use as part of a file. The area must be made 
available by first removing any file if necessary. 


Warnings: 


Once sectors are deleted via XD from a disk, they can be restored to use only by a disk initialization. Do 
not therefore XD a larger area than required. | 


As XD alters the disk directory, do not run any other programs with it. 


Do not execute XD from the same disk as the one from which sectors are to be deleted: for example, it 
is recommended that XD is always executed from the system disk and always deletes sectors from a user disk. 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


Successful termiration None. 
of XD. | | 


DISK disk=-name _ Specified disk is not Check Input: make disk 
FOR xD NOT AVAILABLE available. ready. 
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ONLY atlengtha 
SECTORS CAN @E 
DETECTED 


AVAILABLE TABLE FULL 
- ENTRY dQaddressa 
dtencgtha LOST 


SECTORS FOR xO 
NOT IN AVAILABLE 
TABLE 


POSSIBLE CAUSES 


Onty the given length 
can be X0“ed because 
the amount soecified 
is greater than the 
available space at 
that point. 


No entries left in 
available space 
table for XD to 
complete properly. 


Requested sectors 
are atlocated to a 
file» missing» 

or previously 
XD-ed. 


SUGGESTED ACTION 


Use the KA utility yo 
determine if any files 
can te removed to 
increase the available 
space surrounding 

the bad afea. 


The cisk may still be 
used» but a KA will 
indicate some sectors 
which cannot be access* 
eds these may only be 
retrieved by initial- 


Refer to a XA Liste 
ing to determine 
which file» if any» 
can te RM@ed to 
make the sectors 
avaitabte. 


Note: Refer to “Common Utility Output Messages” for additional messages. 
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SECTION 5 
THE SORT/MERGE 


INTRODUCTION 


This section describes the capabilities of the SORT facility. There are two modules: the sort itself, known 
as the “sort intrinsic” (file-name SORTINTRINS), and an interface to this intrinsic which allows the user to 
specify particular sorts and merges. The latter module is sometimes called “the sort’, but is more properly called 
the ‘‘sort language processor” (file name SORT). The sort intrinsic is implementation-dependent, as it uses spe- 


cific hardware features where possible (although output messages are standardized), while the sort language pro- 
cessor is a CMS common item. 


This section first describes the user interface to the sort, and then covers the various facilities in some detail. 


The interface to the sort from COBOL programs is described in the COBOL language reference manual. 


GENERAL FEATURES 


The following capabilities are provided : 


The records within a file may be sorted on a series of specified keys, each key ascending or descending, using 
a regular sort or an in-place sort. 


A tagfile (suitable for use as an ADDROUT file in RPG or for limited access in COBOL) may be created 
from a file using a series of keys, each ascending or descending. 


A key file (suitable for full indexed access) may be created using a specified unsigned key (ascending only), 
with an optional check for duplicate keys. 


A number of files may be merged using a series of keys, each ascending or descending. 
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INVOKING THE SORT 


The sort is executed by entering the name SORT preceded by disk-name if not on the system disk, and fol- 
lowed by the sort language specifications or an asterisk plus “‘star-file’ name. The “star-file” contains the sort- 
language statements, and may reside on card, cassette, or disk. The star-file name may be omitted: in which 
case the sort statements must be on a system disk file named SORTSPEC. 


Examples: 


To invoke the sort using a star-file named SRTLANG on the system disk: 
SORT SRTLANG 


To execute the sort from disk PB4 using a star-file SORTSPEC on the same disk: 
PB4/SORT PB4/SORTSPEC 


Note that the star-file must have a record size of not more than 90 bytes. If the sort specification is given 
in the initiating message it cannot be longer than 255 characters. If the sort statement is zipped from a use 
program it cannot be longer than 716 characters. If it is not possible to specify a complex sort or merge within 
these limitations, a star-file should be used. 


For a one-part star-file name of 7 characters or less, the file will be searched for first on cards, then on cas- 
sette, then on the system disk. For a two-part name the file will be searched for on a user disk. For a one- 
part name of more than 7 characters, the file will be searched for on the System disk. 


If the required file is not found, the sort displays 
FILE filename UNAVAILABLE 
FIX AND REPLY “OK” ELSE <NULL> 


and waits on an ACCEPT. 


There are two alternative responses: 
make the file present and enter OK to the ACCEPT, to resume execution, or 
enter a null response (terminator only) to the ACCEPT, to cause EO]. 


If the specification statements are provided in the initating message, control characters such as carriage return 
and line feed are treated as space characters. 


A star-file on cassette must be created by the COPY utility, not the LD utility. 
A star-file on disk must be of type data or source, and should not be in use by other programs. 


Input statements may be printed on the printer, unless inhibited by a user option (see later), or if provided 
in the initiating message. 
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THE SORT LANGUAGE 


The specification for a sort consists of three statements: 
the FILE statement 
the KEY statement 
the USER-OPTION statement 


There must be one file statement, one key statement, and, optionally, one or more user-option statements, 
in any particular sort invocation. All keywords are reserved: that is, they can only be used in the place specified 
below and cannot be used for other purposes such as filename. 


The File Statement 


This consists of two parts; the first describes the input file(s) and the second describes the output file. Multiple 
input files are used only for the merge, which is specified as a user-option (see later). A sort must have only 
one input file; a merge may have up to 16 input files. 


Format: 


FILE 
FILES 


DISK | PURGE 


| Ny CARD | NV, | ; V 
IN mfid / fid TAPE records ) 


CASSETTE PURGE record-size per-block 
DISK 
KEYFILE : 
TAGFILE 
| CARD 
TAPE records 
OUT mfid / fid —( CASSETTE record-size per-block ) 
| DISK 
PRINTER 


The parentheses “(’’ and ‘)’? may be replaced by the characters “<”’ and “*>” respectively. 


Rules for the file statement are as follows: 


The medium for the specified input file(s) and output file is indicated by the keyword DISK. CARD, etc. 
When the medium is DISK, the absence of a disk-name (mfid) indicates the system disk. CARD refers to 80- 
column card only. TAPE refers to magnetic tape only. CASSETTE refers to magnetic tape cassette only. DISK 
refers to any kind of disk-device. The input file for a tagfile or keyfile creation must be on disk. 
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The PURGE option indicates that the input file(s) are to be purged after use. 

The record size and records-per-block values are numeric values. When the input medium is DISK, the record 
size and records-per-block may be omitted. For a merge specification, input disk file descriptions with record 
size specifications may be interspersed with descriptions without such specifications. 

If the records-per-block is omitted and record size is given, a blocking factor of 1 is assumed. 


In all cases (except an index sort), input and output files must have the same record sizes. 


The values of record size and records-per-block may be omitted for output files. For a sort, the values as- 
sumed are those of the input file. For a merge, the values assumed are those of the first specified input file. 


For a keyfile creation sort, the output specification enclosed in parentheses must be the single word KEY- 
FILE. The output will be on disk and record and block sizes are not user definable. 


For a tagfile creation sort, the output specification enclosed in parentheses must be the single word TAG- 
FILE. The output will be disk and record and block sizes are not user definable. 


The Key Statement 


This statement defines the record key(s) that are used for the sort or merge. 


A number of keys may be specified, each key description being enclosed in parentheses. The first key will 
be the major key and additional keys will be minor keys of decreasing significance. 


Format: 


ALPHA 


ASCENDING | UA 
A NUMERIC R 
KEY ( location length DESCENDING UN L ) 
D SA 
SN 
SSA 


The “location” is a numeric value specifying the position of the key relative to the start of the record, in 
4-bit units. The first 4-bit unit has a location of 1. The key location is given by the position of the left-hand 
4-bit unit in the key (which, depending on the key format), may be a character or a sign. The key should start 
on a byte boundary unless a record sort with a numeric key is performed. | 


The “length” is a numeric value specifying the key length, in 4-bit units. This must include the sign, for signed 
keys. | | | 


The keywords ASCENDING and DESCENDING determine the order of collation. These keywords may be 
abbreviated to A and D respectively. If omitted, the default is ASCENDING. 


The format of the key is specified by one of the following keywords: 
ALPHA or UA - unsigned 8-bit alphanumeric 
NUMERIC or UN - unsigned 4-bit numeric 
SA — signed 8-bit alphanumeric 
SN — signed 4-bit numeric _ 
SSA — 8-bit alphanumeric with separate sign 


54 


The default is ALPHA. 


For a signed key, the position of the sign is specified by one of the following keywords 
R - right-hand (least significant) end of key 
L — left-hand (most significant) end of key 


The default in L. 
For a description of key types and sign zone interpretation, see later under “KEYS”. 


The User-Option Statement 


These statements have three functions: 

to specify which function is required 

to tailor a sort or merge to the particular machine configuration (memory, printer availability, etc). 
to add comments 


The user-option statements are optional; if more than one are used they may appear in any order relative 
to each other or to the file and key statements. 


INDEX 
INPLACE- 
MERGE 


SYNTAX 
NOPRINT 
NODISPLAY 


Format: 


NODUPLICATES 
DUPLICATES 


COMMENT comments 
FILESIZE number-of-records 
MEMORY memory:size 
WORKDISK -disk-name 


The type of sort is given by one of the keywords INDEX, INPLACE, or MERGE. If one of these does 
not appear, a regular full record sort is assumed. The keyword INDEX specifies the creation of a keyfile or 
tagfile, depending on the output file details (see FILE statement). The keyword INPLACE specifies a full record 
sort using a minimal amount of disk work space. The keyword MERGE specifies a merge of several input files. 


Note that if the INPLACE option is specified on a system that has not implemented the inplace sort. then 
a regular full record sort will be performed. 


The keyword SYNTAX specifies that a check on the correctness of the sort statements is to be made without 
the sort actually being performed. | 
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The keyword NOPRINT stops the listing of the sort statements on the printer. If used, this keyword should 
be the first entry. If the statements are input via the SPO they are not printed and so this keyword is not re- 
quired in this case. The NOPRINT option also affects the printing of error and warning messages (see later). 


The keyword NODISPLAY controls the display of messages on the SPO during the sort. This option can 
be used both in initiating messages and from file-oriented statements. It suppresses startup and termination mes- 
Sages. It does not affect the display of error and warning messages. Error and warning free sorts and merges 
will show no SPO activity if this option is used. 


The keyword NODUPLICATES specifies that duplicate keys are not allowed in a keyfile creation. The key- 
word DUPLICATES specifies that duplicate keys are allowed in a keyfile creation. Both options are valid only 
when creating a keyfile. If neither is specified, the default is NODUPLICATES. 


The keyword COMMENT introduces comment text. The end of the comment text is either the end of the 
input or the end of a record if the input comes from a starfile. Comments may appear between user-option 
Statements and between file descriptions and key descriptions. | 


The keyword FILESIZE provides the following capabilities: 


specification of sort disk work space where the input file is not on disk (this use is not required if the input 
is from disk). | | 


specification of maximum size of the output file if on disk. 


allowance for future expansion of the output disk file where the sort/merge will not by default create a large 
enough file. 


This keyword should be followed by a number giving the specified maximum number of records. For non- 
disk output files, the value is used for optimization purposes. If not used, default values are assumed where 
necessary. This option is not applicable to the inplace sort or to keyfile or tagfile creations. 


The keyword MEMORY specifies the amount of non-overlayable work area to be used by the sort. This op- 
tion is not applicable to the merge or to the inplace sort. If this is not enough for a successful sort, then this 
option is overridden. The memory size is in bytes; for example, MEMORY 1024. 


The keyword WORKDISK enables the regular sort to utilize disk space in an efficient manner. It is not appli- 
cable to the merge or inplace sort. When the work-disk is specified, the sort locates up to half the work space 
on that disk, with the rest on the system disk. If this option is not used, but the input or output file is resident 
on a user disk, the work space is shared between that disk and the system disk. In all other cases the work 
space is located entirely on the system disk. The named disk may be any type of disk applicable to the system 
in use. 3 


- Examples 


To sort the system disk file INP.FILE using the key starting at character 5 of length 3 characters, creating 
a system disk file OUT.FILE: 
SORT FILE IN INP.FILE (DISK) OUT OUT.FILE (DISK) 


KEY (9 6) 


To create a keyfile OUTKEY.FILE on disk PR2 from a data file INP.FILE1 on disk PR2, using a 5-byte 
key starting at the first byte: ; 


SORT FILE IN PR2/INP.FILE1 (DISK) 
OUT PR2/OUTKEY.FILE (KEYFILE) 
KEY (1 10) 
INDEX | 
COMMENT DUPLICATES NOT ALLOWED 


To merge the three system disk files FILE1, FILE2 and FILE3 into an output file MERGE.OUT: 
SORT _ 
FILE IN FILE1 (DISK) FILE2 (DISK) FILE3 (DISK) 
OUT MERGE.OUT (DISK) 
KEY (5 10) 
MERGE 
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FUNCTIONAL DESCRIPTION — | @ 


The five functions of the sort are described here: 
Regular record sort. 
Inplace record sort. 
Keyfile creation. 
Tagfile creation. 
File merge. 


Regular Record Sort 


All the records contained within the specified input file are ordered using one or more keys. Deleted records 
(see later) are not included in the output file. See later for details of the keys. Refer to figure 5-1 for an example 
of a regular record sort, where the key is starting in byte 3 and is 5 characters long, and the sort is in ascending 


Ea Pe 


order. The X’s refer to any other characters. 


The input file must be wholly contained on one hardware type, although it may be a multi-reel or dual-disk 
file. No other programs may write to this file during the execution of the sort. 


The sort uses non-overlayable memory during execution. The amount is calculated according to the input file 
and key sizes. The amount may be specified as a user option, in which case the specified amount is used unless 
it is less than enough for a successful sort. In the latter case the specified value will be overridden. 


The sort uses disk work space, of up to 2.2 times the size of the specified input file. For the location of 
the work disk space, refer to the WORKDISK user option (see earlier). This work space is returned to the 
system at end-of-job. | 


Inplace Record Sort 


This is the same as the regular record sort, except that the records are sorted within the input file. No new 
output file is created. The time taken is substantially greater than a regular sort, for the same input specifica- 
tions. If deleted records are present in the file before the sort, they are removed: hence the number of records 
in the file may decrease after it has been ordered. 


The inplace sort uses non-overlayable memory during execution. The size of this area cannot be specified at 
initiation. | 


The input file must be on disk. No other programs may access this file during execution of the inplace sort. 
The output file must be the same as the file specified for input. | 


If a particular system does not implement an in-place sort, a regular sort will be performed instead. 


The inplace sort uses disk work space, of 0.2 to 0.3 times the size of the input file. When the input file is 
resident on a user disk, up to one-half of the work space is located on that disk, otherwise all work space is 
located on the system disk. This work space is returned to the system at end-of-job. 
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Keyfile Creation 


A new file (the ‘“‘keyfile’’) will be created containing one record for each record of the input file (the ‘data 
file”). The keyfile is sorted in order of the specified keys, and each keyfile record contains the key and a pointer 
to the corresponding record in the data file. Any deleted records in the data file are not referenced in the key- 
file. Note that the records in the data file are not re-ordered and deleted records in the data file are not re- 
moved. Refer to figure 5-2 for an example of a keyfile creation, where the key is starting in byte 3 and is 5 
characters long, and the sort is in ascending order. The X’s refer to any other character. 


Duplicate keys are not allowed unless specified (see the user-option statements DUPLICATES and NODUP- 
LICATES). If they occur, then the record number is displayed on the SPO for each such occurrence, and the 
sort will continue but the output keyfile will be purged at end-of-job. | 


The keyfile creation uses disk work space, of up to 2.2 times the size of temporary file created by the sort 
in this case. This file is large enough to contain one record with the key value and record number for each 
record in the input file. For the location of the work disk space, refer to the WORKDISK user option (see 
earlier). This work space is returned to the system at end-of-job. 


Certain key values are not allowed during a keyfile creation. The key must not consist of all binary zeroes, 
or must not contain any byte whose value is hex FF. If such a key is encountered, the record number is dis- 
played on the SPO, and the sort will continue but the output keyfile will not refer this record in the data file. 


Tagfile Creation 


A tagfile creation is similar to a keyfile creation, except that the output file contains only the record pointers, 
and not any key values. The tagfile records, however, are ordered in key value order, as specified by the sort. © 
Any deleted records are not referenced in the tagfile. Refer to figure 5-3 for an example of a tagfile creation, 
corresponding to the keyfile creation in figure 5—2. 


A tagfile is a null keyfile. It is suitable for use as an ADDROUT file in RPG, and for limited indexed access 
in COBOL (the tagfile is read sequentially). 


Disk space requirements are the same as for keyfile creation. 


Merge 


The merge merges up to 16 input files, using one or more specified keys, producing one output file. Deleted 
records in the input files are not included in the output file. If there are duplicate keys values, the order in 
which they are placed in the output file is given by the order in which the input files are specified. 


Each input file must be wholly contained on one hardware type, although it may be a multi-reel or dual- 
disk file. No other programs may write to these files during the execution of the merge. | 


Each input file must have the same record size and the same position and length for each key. Each file 
must be already correctly ordered on the specified keys. If this is not the case, the merge will terminate prema- 
turely after displaying a message on the SPO. ? 


Refer to figure 5-4 for an example of a merge of two files, with a key starting at byte 3 which is 5 characters 
long. The X’s and Y’s refer to any character. 


The merge uses non-overlayable memory during execution. The size of this area cannot be specified at initia- 
tion: it will be approximately equal to the sum of the block sizes of the input files and the output file. 


The merge does not use any disk work space. 
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Details Of Sort Keys 


A “key” is the field within each record that is used for sorting or merging. If several distinct field within 
a record are specified, then each field is a separate key. The relative order of importance of the keys is deter- 
mined by the order in which they are specified. Figure 5-5 illustrates this with a two-key sort, using the KEY 
statement. : 


KEY (5 6 ALPHA) (15 2 DESCENDING ALPHA) 


The X’s indicate any character. In this example the three-byte field is the major key, sorted in ascending 
order: the one-byte key is a minor key sorted in descending order within the order of the major key. 


For a keyfile creation, only one key may be used. This key must be a maximum of 28 bytes long, must be 
a whole number of bytes in length, and must start on a byte boundary. | 


For all sorts except keyfile and tagfile creation, there can be up to 10 keys. The sum of the length of all 
keys (including signs) must be a maximum of 29 bytes. 


The available key types are discussed here, under the keyword specified in the KEY statement (see earlier): 


ALPHA (or UA) 


Unsigned 8-bit alphanumeric field, conaining ordinary ASCII characters. Note that this may consist of the 
8-bit ASCII digits “0” to “9” but still be termed alphanumeric. This key type is the default. 


NUMERIC (or UN) - 


Unsigned 4-bit numeric field, where each 4-bit unit is a binary coded decimal digit, 0000 to 1001 (0 to 9). 


SA 


Signed 8-bit alphanumeric field. Each byte is an ordinary ASCII character (including the digits 0-9), except 
that either the first or the last character indicates the sign. Whether the sign is the first or last character is 
specified by the keyword L (left) or R (right). The default is L (first character; leading sign). The convention 
for coding the sign character is given in Table 5-1. These characters are termed ‘‘overpunched signs” by anal- 
ogy with historical punched card systems. 


SN 


Signed 4-bit numeric field. Each 4-bit unit is a binary-coded decimal digit, 0000 to 1001 (0 to 9), except that 
either the first or the last 4-bit unit indicates the sign. Whether the sign is the first or last 4-bit unit 1s specified 
by the keyword L (left) or R (right). The default is L (first 4-bit unit); leading sign . The convention for 
coding the sign is given in Table 5-2. 


SSA 


8-bit alphanumeric field with separate sign. Each byte is an ordinary ASCII character (including the digits 
0 to 9), with the sign given by an ASCII character in either the first or last character. Whether the sign is 
given by the first or last character is specified by the keyword L (left) or R (right). The default is L (first 
character); leading sign . The convention for coding the sign character is given in Table 5-3. 


The position of a sign within a signed key (left or right) must be the same throughout all occurrences of the 
key. Signed keys are ordered so that negative values come before zero and positive values 


8-bit keys may start on 4-bit unit boundaries, unless the separate sign type (SSA) is used, or the key is to 
be used in keyfile or tagfile creation. | | 


Deleted Records 


A deleted record is denoted by every byte in the record (including the key) containing the value hex FF. 
The action taken by the various sort options is discussed earlier. Deleted records may be physically removed 
by the FS utility. : 
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Output Messages 


Output messages cover warnings and errors. Messages are generated by both the sort intrinsic and the sort 
language processor. The intrinsic messages are numbered by event numbers in the same way as MCP output 
messages (see section ). The sort language processor messages are numbered in a similar way. 


Messages can be divided by number as follows: 
0-99 


Sort language processor messages, displayed on the printer. Such messages appearing in the list below that 
are followed by a series of dots (...) should be read with the phrase NEAR COL XXX (with XXX replaced 
by an appropriate column number) in place of the dots. 


0-34 
Warnings, where corrective action is attempted. 
35-39 | 
Warnings, where no corrective action is attempted. 
40-59 
Errors in syntax (that is, the format of the sort statements is incorrect). 
60-99 


Errors in semantics (that is, an inconsistency has been detected in the statements, such as a key position 
greater than the record size). 


170-200 


Sort intrinsic messages, displayed on the SPO. 
Certain messages may be suppressed by the NOPRINT and NODISPLAY keywords in the sort statements. 


The NOPRINT option suppresses listing of the sort statements on the printer by the sort language processor. 
If this option is set, a maximum of five errors and four warning messages are directed to the SPO, with only 
the error or warning number being given (no explanatory text). The NOPRRNT option has no affect on sort- 
intrinsic-generated messages. 


The NODISPLAY option suppresses display on the SPO of start-up and termination messages by the sort 
intrinsic. Messages in the list below that are marked with an asterisk (*) are those that are suppressed when 
this option is set. Note that it is not possible to suppress individual messages; every applicable message is sup- 
pressed if the option is set. The NODISPLAY option has no affect on sort language processor messages. 


Number Messaae 


EXPECTED SLASH NOT FOUND» “/" INSERTED ..-- 

EXTRA "FILE IN"... 

MERGE INTRINSIC IGNORES <WOIRK-DISK OPTION> 
OVERLERGTH PART OF <LABEL NAME> IGNOFEC ... 

INPLACE INTRINSIC IGNORES <WORK"DISK OFPTIOQN> 
EXPECTED BRACKET NOT FOUND» s«<™ INSERTED ..- 
<DUPLICATE OQPTION> VALID IN INDE X“KE YFILE SORT ONLY 
EXPECTED BRACKET NOY FOUND» ">" INSERTED ... 
ILLEGAL TO DELETE INPUT FILE» <PURGE OPT> IGNORED 
QUTPUT BUFFER SIZE TCO BIG» <BLECK FACTOR> REDUCED .. 
<USER OPTION> ALREADY INVOKED» LATEST USE oo 


OO DNDU EWN & © 


| pm 


2007258 | 5~11 


Number Message | 
11 MERGE <SORT TYPE OPTION> NOT SPECIFIED ©} 


12 OVERLENGTH PART OF <DISK NAME> IGNORED ... 
13 MISSING "FILE INW 2... 

14 INDEX <SORT TYPE OPTION> NOT SPECIFIED 

15 EXTRA MIE Y™: seas : 

16 <FILE SIZE OPT> VALID FOR MERGE/REGULAR SORT ONLY 
17 MISSSNG "KEY" ... 

18 INPLACE INTRINSIC IGNORES <MEMORY OPTICN> 

19 | <M“FILE/OP ID> IGNORED ON NON@MACNETIC MEDIA FILE ... 
20 NUMBER TOO BIG» MAXIMUM VALLE ALLOWABLE ASSUMED ... 
21 not used . 

22 <SIGN POSITION> GIVEN FOR UNSIGNED KEY ce. 

23 FIRST UNIT NUMBERED Cc RATHER THAN 1 2... 

24 <FILE SIZE OPT> IGNORED SINCE OUT OF RANGE ... 

25 MERGE INTRINSIC IGNORES <MEMORY CPTICN> 

26 <BLOCK FACTOR> OF © NOT ALLOKED> 1 ASSUMED oc. 

27 IN ANC OUT"FILE RECORD SI7ES MADE EGUAL 

28 <BLOCK FACTOR> TOO LARGE» MAXIMUM ASSUMED oe. 

29 INPLACE SORT MUST HAVE IDENTICAL IN= AND OUT-FILES 
35 IDENTICAL IN/OUT = FILES WILL PRODUCE CUPLICATE FILE 
36 NOT NECESSARY TO PURGE CARD FILE ... 

(37 ALPHANUMERIC KEY 90£S NOT START ON BYTE BOUNDARY ... 
40 <KEY STATEMENT> ALREADY FROCESSEL» NCW ce. 

41 <DIGIT STRING> EXPECTED ... 
42 <CHARACTER STRRNG> EXPECTED 2... 

(4S <SEPARATOR STRING> EXPECTED ... & 
4 4 <RCRD-BLCK PAIR> MUST BE GIVEN FCR NON“DISK IN-FILE ce. 
50 NO <FILE STATEMENT> SPECIFIED 
51 ILLEGAL WORD ... 

52 <LETTER STRING> EXPECTED ... 
53 MISSING <LASLE NAME> ... 
54 UNSUPPORTED <IN/OUT MEDIA> ... 
55 UNSUPPORTED <SORT TYPE OPTION> ... 
56 PART OF <FILE STATEMENT> MISSING» NOW 22. 
57 NO <KEY STATEMENT> SPECIFIED 
5 8 <FILE STATEMENT> ALREADY PROCESSED» NOW ... 
59 FINAL STATEMENT INCOMPLETE ... 
69 TOO MANY KEY SPECIFICATICNS ... 
61 TOG MANY FILE SPECIFICATIONS ... 
62 INPUT FILES RECORD SIZES NOT IDENTICAL ... 
63 <RECOGRD SIZE> OUT OF RANGE ... | 
64 EXTRA DIGITS IN QVERLENGTH STRINC IGNORED ... 
65 KEY LENGTH OUT OF RANGE ... 
66 MIN LENGTH OF SN KEY IS Tw 4*81T UNITS ... 
67 BUFFER SIZE TOO LARGE ... 
6 8 — DUPLICATE <IN@FILE PARAMS>» LATEST INSTANCE ... 
69 BUFFER SIZE TOO BIG FOR <IN/QUT MEDIA> «.. 
70 ONLY ONE IN“FILE LEGAL FROM MULTIPLE TAPE ... 
71 MERGE INSTRINSIC NEEDS AT LEAST 2 INFUT FILES 
72 INDEX PARAM MUST SE *OUT...<KEYFILE/TAGFILE>® 
73 KEY OVER@RUNS RECORD BOUNDARY 
74 ILLEGAL TO OVERWRITE INPUT FILE WITH TAG/KEY FILE @ 
a es 


Message 

ALPHANUMERIC KEY LENGTH NOT EVEN NUMBER OF 4°BITS” 
<MECIA> MUST BE DISK FOR IN“PLACE SORT 

IN@- AND OUT-FILE RECORD SIZES MUST BE IDENTICAL 
INDEX“KEYFILE KEY LENGTH NOT EVEN NUMBER OF &-BITS 
ONLY GNE KEY LEGAL IN INDEX"KEYFILE SORT 
INDEX“KEYFILE SORT KEY TCO LONG 

INDEX“KEYFILE SORT KEY MUST BE “eee A UA/SUN>® 


ONLY INDEX SORT CAN SPECIFY "KEYFILE/TAGFILE™ 


INCE X“KEYFILE SORT KEY MUST START ON BYTE BOUNDARY 
MIN LENGTH OF SSA KEY IS FOUR 4°*BIT UNITS ..- 

SSA KEY MUST START ON BYTE BOUNDARY -.- 

CURRENT SUM OF KEY LENGTHS OUT CF RANGE ee 
DUPLICATE RECORD <record numter> 

ILLEGAL INDEX KEY IN RECCRO <record nufber> 
RECORDS COST / GAINED BY SORT~MERGE 

<number> DUPLICATE RECORCS 

<Cnumber> RECORDS CONTAINING INVALIN INDEX KE YS 
<number> DELETED RECORDS 


<number> RECORDS MERGED 


<number> FILES MERGED 

SORT@“MERGE OUTPUT FILE NCT CREATED 

SORT=MERGE ABNORMAL EOJ 

SORT*MERGE SOFTWARE ERROF 

<number> RECORDS REFERENCEO BY KEYFILE/TAGFILE 
NO INITIATING MESSAGE 

<number> RECORDS SORTED 


FILE ERROR <<number>> NEAR RECORD <record number> ON 


<file name> 
UNORDERED MERGE INPUT FILE <file name> NEAR 


FECOFDR <record number > 


TOG MANY RECORDS FOR SORTMERGE 

DUPLICATE RECORCS"“KEYFILE NOT BUILT 

INITIATING MESSAGE INVALID 

SORT*MERGE VER xeyez INITIATED FROM <nix number>/ 


<progqram name? 


INPUT RECORD SIZES UNEGUAL = BAD FILE <filename> 
IN/JOUT RECORD SIZES BAD ~ OUTPUT SIZE CHANGED 
BAD RECORD/BLOCK SIZE FCR OUTPUT DEVICE 

KEY OVER“RUNS RECORD END 

CANNOT SPLIT INDEX FILE 

<number> PARITY BLOCKS 


Message 184 represents differing file errors depending upon the value of <number>. Defined meanings are 


as follows: 


1 — EOF on output file 
2 — parity on input file 
3 - EOF on sort workfile 


7 -— output file error 
8 — parity on sort workfile 
9 — parity on input file (block ignored) 


4 — parity on output file 


5 — sort workfile error 


6 — input file error 
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record 
number 


xX X10 109 3]X xX xX 


Xx X10 216 7/K x x 


X X11 003 SIX x x 


X X11 0 0 3 6{X X X 


xX X11 05 2 O1X X X 


X X¥/1 9 5 2 OFX X X 1 


X X11003 51x X x] 2 


X X10 10 C0 3]xX xX X 3 


X X169 714 21K Xx YX 4 


X X16 9 8 4&4 3]X X xX 5 


X X}/1 09 3 6/X Xx x 6 


X X13 24 0 O]|X X X 7 


X X10 214 7/X X X 8 


data file : < : data file 
input : output 


X X16 9 7 1 2K xX xX 


X X16 9 84 31K X X 


record 
number 


X X11 05 2 OFX X xX 1 


X X}/1 00 2 51x KX x 2 


X X10 10 0 3;X xX X c 


X X16 9 7 1 21K X X 4 


Xi6 9 8 & 3{]X XK xX 5 


08 1/0 214 7 


Gee 1.0.0 3 -5 


061109 3 6 


190 3 61X x x 6 


xX X X 


X xJ0 214 71X xX YX 8 


data file  keyfile 
input | 2 4 cutcut 


05 {6 9 & & 3 


Figure 5-2. Keyfile Creation 
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69 8 4& 3 


10090 3 6 


324 0 0 


data file | tagfite 
input output 


Figure 5-3. Tagfile Creation 
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0100 3 


0214 7 


1 ae § 


me 


, 


yy 


Y ¥ 
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32490 0 


69 8 & 3 


0 8 7 26 


100 3 8 


20001 


4216 8 


49 1 3°7 


X X ¥ 


x x x 


Xx xX X 


X X X 


X X X 


X X XxX 


x X XxX 


xX xX YX 


Y Y Y 


YY Y 
YY yY 


YY Y 


YY Y 


input fites 


Figure 5-4. File Merge 


0100 3/x x x 
0214 71x x x 
08 7261Y YY 
1003 5|x x x 
1003 6/X x xX 


1003 8@IY Y Y 


1052 0|x x x 
2cco1lryy 
3240 CIX xX xX 
w2e1.6alryy 


69 8 & 3]xX x xX 


output fite 


or_oehH tt ~r 8 


5 
4 
3 
4 
0 
: 
9 
0 


data file 
output 


Figure 5-5. Multiple Key Sort 


Table 5-1. Sign Convention For Signed 8-Bit Alphanumeric Fields 


Key Value Hex Code ASCII Character 
=< | 2D = 
-C 70 “ 
+0 30 0 
#0 7B un 
=1 4A J 
-3 4B K 
-% 4&C L 
wh 4&D M. 
“5 4E N 
“6 4F 2 
«7 5C p 
=e 51 Q 
-9 52 R 
+] 31 1 
+2 $2 2 
+3 ee 3 
+ & 34 rN 
+5 35 5 
+6 36 6 
+7 37 7 
+8 38 8 
+S 39 9 


Note: any other hex code tn the sign character 15 interpreted as 
positives with the key value given by the binary vatue of the 


right~hand 4 hits of the character. 


2007258 5-17 


5-18 


Table 5-2. Sign Convention For Signed 4-Bit Numeric Fields 


Key vatue Binary Code (BCD character) 
negative 0101 (5) 

positive 0011 (€3) 

Notes any vatue other than 0101 (5) is 
interpreted as positive. 


Table 5—3. Sign Convention for Separate Sign Character with 8-bit Alphanumeric Fields | 


Key value ASCII character (hex vatue) 


negative irae (20) 
positive "+" (28) 


Note: any character other than "°" is interpreted 
as positive. 


SECTION 6 
COMPILATION FACILITIES 


INTRODUCTION 


Compilation of programs written in CMS COBOL, RPG and MPL can be performed with the CO (compile) 
utility. CO is a normal utility program residing on disk. It is used to co-ordinate the various parts of the CMS 
COBOL, RPG and MPL compilers. Each compiler consists of several object code files (called “passes’”) and 
produces a number of workfiles to pass information between each pass. The CO utility allows initial input to 

be made to the compiler by specifying such things as input and output file names. 


Additionally, CO allows multiple executions of each compiler by storing compiler workfile information in a 
master file called CO.MASTER on the system disk. The compiler passes have access to the information in this 
disk file. Information in this file also allows the CO utility to perform restarts if the system halts during a compi- 
latin. This restart facility eliminates the need to rerun a compilation from pass one if one or more passes have 
already completed successfully. 


CO uses some standard names for input and output files, which can be changed by the inital CO message. 
The basic CO operation is given in Figure 6-1. 


Initial input to CO is either from the initiating SPO message or through macro (star) files or through a disk 
file called ‘CO.STARTUP” on the system disk. CO generates the CO.MASTER file used to co-ordinate the 
compiler passes. There is an option to produce a CO listing. Information provided to CO enables the user to 
describe the following: 


input patch file 

input source file 

output source file 

output object program 
output compilation listing 


compiler workfiles 
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INITIATING MESSAGE 


CO.MASTER 
STAR FILES 


co (DISK) 
UTILITY 


(DISK) 


CO.STARTUP 
(DISK) 


co ; 
LISTING : 
COMPILER 


(PRINTER) 
PASSES 


PATCHFILE 
(DISK) 


SOURCEIN 
(DISK) 


SOURCEOUT 
(DISK) 


OBJECT 
PROGRAM 
(DISK) 


Figure 6-1. Operation Of CO Utility 


CO provides the ability to set “dollar options” for the compilation. 


CO operates in two basic ways | 


to 
to 


6-2 


initiate and control a single compilation. 
interrogate compilation status, and restart or clear an aborted compilation. 


COMPILER 
WORKFILES 
(DISK) 


COMPILATION 
LISTING 


(PRINTER) 


TO INITIATE A SINGLE COMPILATION 


| disk-name / | object-program name | disk-name / compiler-name 
| compiler-option | PRINT file-statement | MESSAGE text 


Format: 


CO 


This initial input can be entered on the SPO when executing CO. CO can also be started with no additional 
information from the SPO: in this case the information is either on a card file or on a disk file called “CO.STA- 
RTUP” on the system disk. Selected parts of the input can be provided as star files see later in this section. 
All disk files used for inputting information to CO can be 80 byte card-image records created by CMS CANDE 
or CREATE, with all information in the first 8 records and the first 72 characters of each record. 


Semi-colons may separate any clauses after the compiler-option, for readability. 


The object-program-name is optional. If not specified, it will be created on the system disk with a name as 
follows: 


“COBOBJECT” — for COBOL compilations 
“RPGOBJECT” — for RPG compilations 
“MPLOBJECT” — for MPL compilations 


The name of the disk for the generated object program may also be specified. If not specified, the system 
disk is assumed. 


The compiler-name may be one of the following: 
COBOL - the COBOL compiler 
RPG —- the RPG compiler 
MPL — the MPL compiler 
RPGXREF -—- the separate RPG cross-reference program 
OPTLIST — the separate COBOL/RPG optimizer 


If the optional disk-name is given before the compiler-name, then the compiler may be executed from a user 
disk so long as all passes are on the specified disk. If no disk name is given then the compiler must be on 
the system. 


The compiler-option may be one of the following: 
SYNTAX (abbreviation SY) 
LIBRARY (abbreviation LI) 
GO (alternative SAVE) 


With a “compile for syntax‘, no object program is generated. For COBOL and RPG, COBSVERTER is 
not executed; for MPL, the compilation stops at the end of pass 3. 
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With a “compile to library‘, an executable object program is created if there are no syntax errors, and saved 
on disk with the object-name as specified in the CO statement. A compile to library is the default compiler- 
option. 


A “compile and go” is the same as a compile to library, with the additional feature that the object program 


is executed. The CO utility goes to EOJ after zipping the object program. 


If the PRINT option is specified, an edited listing of the startup message is output, along with a list of settings 
for all the file parameters which are modifiable through CO. A list of default dollar card settings for the compil- 
ation is output along with any dollar options entered via the CO message. This object listing also contains a 
log of all error messages displayed. : 


The file statements allow names and other attributes to be set for the compiler input and output files. The 
general form of these statements are given here, but not all attributes may be set for all files these will be dis- 
cussed in turn. | 


Format: 


NAME. disk-name / file-name 
MFID_ disk-name : 
PATCHFILE FID file-name 


SOURCEIN DEVICE hardware-type 
SOURCEOUT RECORD number 
WORKFILE | BLOCK number 
PRINTOUT RECORDS.BLOCK number 


FILESIZE number 
FILE.SIZE number 


The meaning of the file attributes are as follows: 


NAME 
This specifies the CMS file name plus disk name and may be of the form MFID/FID. 


MFID 


This specifies the disk name of the given file. The default is the system disk. The MFID must be a maximum 
of 7 characters. 


FID 


This specifies the file name of the given file. The default is the system disk. The FID must be a maximum 
of 12 characters. 


(Note: FID and MFID may be used together, or NAME may be used instead of the MFID/FID combination). 


DEVICE 


This specifies the type of peripheral of the input or output file. The default for the PRINTOUT file is line 
printer. The default for all other files is any disk. The device is specified by a 2-character mnemonic as fol- 
lows: : 3 


card readers: 


any card reader AR 
any multifunction unit AM 
8O-column reader R8 
€C*cotumn reader/punch M8 
96ecoltumn reader RI 
$6°coltumn reader/punch M9 
card punches: 
any card punch cP 
any multi-function unit AM 
&Cecolumnr punch P3 
8C-cotumn reader/punch M93 
96°coluUMn punch P9 
S$6"column reader/punch M9 
tapes and cassettes (NRZ or PE) 
any tape AT 
write-diSabled reel MT 
write"disabted cassette CT 


(altenatvies: CS» CASSETTE) 
Note: if a write*disablec cevice is specified 
for an output filer CO will substitute a 
writetenablea device in the specifications and 
issue warningee-. 
orinters: 


any printer AP 
Serial printer (console) SP 
Line printer LP 
disks: : 
any disk» default catridge OK 
Calternatives: 0C» DISK) 
Burroughs Super Mini DM 
Fixed disk DF 
pack cP 


FILESIZE 


This attribute specifies the maximum number of records in the output file. If used with PATCHFILE, the 
number specifies the total number of source lines to be compiled, including dollar cards and “‘COPY state- 
ments” in the case of COBOL compilation. The number may be followed by the letter K to denote thousands. 
For example, the statement 


FI SOURCEOUT FILESIZE 4 K 
specifies a filesize of 4000 records. A space must separate the ““K” from the number. 
An alternative spelling of the keyword is “FILE.SIZE’’. | 
The files are as follows: 


PATCHFILE 


This is the primary source input file, and contains dollar records and source records which may optionally 
be merged with a secondary input file to produce an output source file. Attributes which may be set, and 
their default values are: 


NAME PATCHFILE 
MFID system disk (0000000) 
, FIO PATCHFILE 

DEVICE | DK 


FILESIZE 0 


Pal 
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SOURCEIN 


This is the optional secondary input file. Attributes which may be set, and their default values, are: 


NAME 
MFID 
FID 
DEVICE 


SOURCEOUT 


SOURCEIN 
system disk (0000000) 
SOURCEIN 


NK 


This is the optional source output file produced by merging PATCHFILE and SOURCEIN. Attributes which 


may be set, and their default values, are: 


NAME 

MF ID 

FID 

DEVICE 
FILESIZE 
RECORD 
RECORDS.8LOCK 
BLOCK 


WORKFILE 


SOURCEOUT © 

system disk (0000000) 
SOURCECUT 

BK 

4 K 

80 

a 

720 for oaisks 

240 for cassettes 

2000 for magnetic tates 


This refers to the intermediate workfiles produced by the compiler during the compilation. The only attribute 


that can be specified, and its default, is: 


MFIO 


PRINTOUT 


system disk (000000C) 


This refers to the listings produced by the various compiler passes during the compilation. The only attribute 


that can be specified, and its default, is: 


ee 


The MESSAGE statement 


iP 


The reserved word MESSAGE indicates the start of the list of dollar options for that compile. The text con- 
sists of a list of one or more dollar cards, taken from the list given below, separated by spaces. 


For example, for an MPL compilation the following would be valid: 


MESSAGE $LIST $XMAP $SEGMENT FR20 


Use of this feature is not valid for COBOL compilations. 


Examples: 


disk: 


To compile the COBOL source program AR678S, and create the object program AR678, both on the aysen 


CO AR678 COBOL LI FI PATCHFILE FID AR678S 


To merge the RPG patch file RQ20P with the source file RQ20S, and create a new source RQ20SN and 
object RQ2Z0NEW, all on disk RDEV: 


CO RDEV RQ20NEW RPG LI; FI PATCHFILE NAME RDEV/RQ20P; 
FI SOURCEIN NAME RDEV/RQ20S; FI SOURCEOUT NAME 
RDEV/RQ20SN; MESSAGE $MERGE 


To compile the MPL source program MTEST.S from the disk USR1 to produce object MTEST on disk 
USRI, with CO listing, and compiler listing on the console: ; 


CO USR1 MTEST MPL LI; FI PATCHFILE NAME USR1/MTEST.S; 
PRINT; FI PRINTOUT DEVICE SPA; MESSAGE $LIST 


To compile source PATCHFILE with COBOL and create object COBOBJECT on the system disk: 
CO COBOL 


To patch COBOL source CS500 (found on tape) with cardfile CRDPATCH and produce an object program 
CNEW on disk F1, putting compiler workfiles on disk FSCRATCH: 


CO FI/CNEW COBOL LI; 

FI PATCHFILE FID CRDPATCH DEVICE AR; 
FI SOURCEIN FID CS500 DEVICE AT; 

FI WORKFILE MFID FSCRATCH; 
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USE OF MACRO CALLS 


All or part of the initiating message to CO may be provided aé data in disk files. This is indicated by an @ 
asterisk (star) in the message. | Soe a 


Following the asterisk must be a valid file name, including the disk-name if not on the system disk. When 
the initiating message is scanned, the contents of a star-file are included in the scan. At the end of the star- 
file contents, scanning continues with the primary message. The complete initiating message, or individual 

_ clauses, may be included in the star-files. The message format for CO has been repeated below with an asterisk 
where a star-file may be used: | | | 


| disk-name / object-program name 
, compiler-option | | PRINT 


Example: 


Format: 


CO * 


7 | disk-name / compiler-name 
J | MESSAGE text 


|  *  file-statement 


Consider four star-files, with names and contents as follows: 


name contents 

FILE! AA RPG GC 

FILE2 : PATCHFILE NAME BB 
FILE? CEVICE AR 

FILES SOURCEQUT FID CC 


Then the following two initiating messages to CO are valid: 
CO *FILE1 PRINT *FILE2 DEVICE AR 
CO *FILE] PRINT #*FILE2 *FILE4 


but the following two messages are invalid, because the contents of FILE3 is wrong, as it starts in the middle 
of a file-statement: 


CO *FILE] PRINT *FILE2 *FILE3 
CO *FILE1 PRINT PATCHFILE NAME BB_ #FILE3 
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COMPILER DOLLAR OPTIONS 


In the following list, (D) indicates the options which are set by default. This notation is also used in the output 
listing from CO, to distinguish default-settings from deliberate dollar card settings. 


For COBOL, no dollar options may be set or reset by CO. For a fuller Sooo of the available RPG 
and MPL options, consult the relevent compiler manual. 


RPG 
$ LIST ()) $ NLIST 
$ SEC € NSEQ) 
$ XMAP $ NXMAP 
£ SUPR $ NSUPR 
$ LOGIC $ NLOGIC 
$ MERGE £ NMERGE 
$ SEVERE (D) £ NSE VERE 
$ MAP ~ NMAP 
$ NAMES $ NNAMES 
$ NEW $ NNEW 


Any RPG dollar options specified in the startup message for CO will override any occurrences of that option 
appearing in either the PATCHFILE or SOURCEIN input files. 


MPL 
$ LIST £ CODE 
$f NOLIST $ NEWTAPE 
$ LISTE $ FORMAT 
$ LISTP $ SEGMENT file-name 
$ SEQUENCE f SEGSIZE integer 
$$ XMAP 
$ NOWARNING 


Any MPL dollar options specified through CO are used only as initial settings, and may be overridden by 
dollar cards appearing in either of the source input files. 
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TO INTERROGATE THE STATUS OF COMPILATIONS 


CO may be used to determine the status of any compilations. This is done by interrogating the CO.MASTER 
file. The message is: : 


CO Mx 


This function may be used at any time, provided that the mix is not already full. It yields information in 
the following form: | 


CO MIX-NUMBER . 
COMPILER NAME | compiter“name 
CURRENT COMPILER PASS | filenéeme 
WORKFILE CKARACTER Wa" 


(where “a” is a character used by CO in the meaning of workfiles so that different compilations can precede 
with separate workfiles). In addition to the above information, if a compilation is either awaiting Restart or 
Clear (see later), or has been Restarted but has not yet gone to end-of-job, the following will be displayed: 


(THIS CO IS IN RESTART MODE) 


Note that the “CO MX” function will give information about all current compilations marked in the 
CO.MASTER file, even if they were prematurely stopped by a system failure. This is different from the MCP 
“MX” intrinsic, which will only give the jobs currently in the multiprogramming mix. 
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TO RESTART AN ABORTED COMPILATION 


This function may be used to restart a compilation which has been terminated prematurely due to a system 
failure such as a clear start or ZIP failure. The message is: 


_ Format: 


CO RESTART | mix-number | line-number 


If only one compilation was being done, then the simple message 
CO RESTART 


is sufficient. The compilation is resumed at the beginning of the pass in which the failure occurred. If more 
than one compilation was being done, the mix-number must be supplied, which is the mix-number of the 


particular CO that was running at the time of failure. This number is determined either from the SPO log, or 
the CO MX facility. 


If the failure occurred during the printing phase of a COBOL compilation (pass COBOL7), then this pass 
can be restarted at a specified line-number. The line number must be in the range 000000 to 065535. For exam- 
ple, the message 


CO RESTART 2 010000 


will cause the CO with mix-number 2 to be restarted, which will cause COBOL7 to start printing at line 
010000. 


Once a RESTART has been initiated, no new compilations can be started until the restarted compilation has 
gone to normal EOJ. If that is not possible, for instance because a file is not present, then the restarted job 
should be CLEARed (see later) to allow other compilations to be initiated. 


Other CO versions executing are undisturbed by a RESTART operation. 


When a restarted job terminates, whether naturally or as a result of a CLEAR (see later), the message 
“RESTART COMPLETED” 


is displayed on the SPO. If a new CO, having the same mix-number as the one that failed, is started up 
before the failed CO can be restarted or cleared, then the block of information in CO.MASTER for the failed 
CO is lost and that compilation cannot be restarted. In this case the followwng message is displayed: 


“CO MIX-NUMBER n CANNOT NOW BE RESTARTED 
COMPILATION BLOCK RE-USED”. 
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TO CLEAR AN ABORTED COMPILATION 


If a clear start or other failure has occurred, and it is decided not to Restart compilations, then on or all 
of the compilations may be cleared. References to one or all of the compilations are deleted from the 


CO.MASTER file, and workfiles belonging to the compilation are removed one the compiler requested that 
they be saved. The message is: 


Format: 


mix-number 
CO CLEAR ALL 


Providing a mix-number clears only the compilation whose controlling CO had the specified mix-number. The 


keyword ALL clears ail compilations known to CO. If only one compilation was being done, then the simple 
message 


CO CLEAR 
is sufficient. 
Other CO versions executing are undisturbed by a CLEAR operation. 
Any CO can be CLEARed at any time whether or not a restart is in operation or pending. 
Example of aborted cornpilauon: 


Assume that a system failure occurred while doing a COBOL compilation. The controlling CO had a mix- 
number of 6 and the compiler was in the OPTLIST pass. Assume also that, since the failure, an RPG 
compilation had been initiated. 


The message 
CO MX 


may result in the following information: 


CO ix NUMBER 4 
COMPILER NAME RPG 
CURRENT COMPILER PASS RPGPRHASE1 
WORKFILE CHARACTER oo 

co MIX NUMBER E 
COMPILER NAME CCBOL 
CURRENT COMPILER PASS OPILIST 
WORKFFLE CHARACTER C 


CTHIS CC IS IN RESTART MCDE) 


Then to restart the COBOL compilation, enter 
CO RESTART 6 
to cause the compilation to start at the beginning of OPTLIST. If the COBOL compilation is not required 
to be restarted, then enter 


CO CLEAR 6 


Note that in both cases the RPG compilation is unaffected. 
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ZIP FAILURES 


If a zip failure occurs, or a particular compiler pass is DS’ed or DP’ed, CO displays one of the messages 
in table 6-1 indicating the reason for the failure, then takes one of the following two actions: 


If no Restart is in operation or pending. 
One of the following messages is displayed: 
‘CO SHOULD BE RESTARTED OR CLEARED“. 
‘CO MIX-NUMBER n MUST BE RESTARTED OR CLEARED“. 


The CO utility is forced into “Restart mode” which prevents any new COs or any other RESTARTS 
being performed until the CO in question has been either restarted and completed, or cleared. 


If a Restart is in operation or pending. 
One of the following messages is displayed: 
“CO SHOULD BE RESTARTED OR CLEARED” 
“CO MIX-NUMBER SHOULD BE RESTARTED WHEN 
EXISTING RESTART COMPLETE”. 


The CO utility is not forced into “Restart mode” in this case. It is required to RESTART the job as 
soon as possible after the existing restart is complete. 


Table 6~1, Zip Failure Messages 


ZIP FAILURE DUE PROGRAM FILE NOT FOUND FOR progr amenare 
ZIP FAILURE DUE TO INTERPRETER FILE NOT FOUNC FOR program-name 
ZIP FAILURE DUE TO NO MEMORY FOR program=néme 

ZIF FAILURE OUE T9 NO USER DISK FOR program=name 

ZIP FAILURE NUE TO MIX FULL FOR program-name 

ZIP FAILURE DUE TO USER COUNT ERROR prograncrame 

ZIP FAILURE DUE TO DUPLICATE PACK program-nare 

ZIP FAILURE DUE TO INVALID LOAD RECUEST program-name 

ZIP FAILURE OUE TO MCS ALREADY PRESENT procrém-name 

ZIf FAILUFE DUE TO DISK ERROR program*name 

ZIP FAILURE OUE TO CODE FILE ERROR procram-néeme 

ZIP FAILURE DUE TO ILLEGAL DATA REGUEST program-name 

ZIP FAILURE DUE TO REASON UNKNOWN orogram=rame 

COMPILER PASS DS*ted program*nane 
COMPILER PASS DP'*'ed orogram=name 
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RESERVED WORDS 


All keywords used in initiating messages to CO are reserved words; that iS, they cannot be used for file names 
or other user-defined parts of the initiating message. A complete list of the reserved words is given in table 


Table 62. CO Reserved Words 


MPL SOURCEOUT 
COBOL WORKFILE © 
RPG | PRINTOUT 
RPGXREF NAME 
OPTILIST MFID 

SAVE FID 

Go DEVICE 
SYNTAX FILE.SIZE 
SY u-,. FILESIZE 
LIBRARY RECORD 


Li BLOCK 

PRINT RECORDS-~6LOCK 
MESSAGE 7 MX 

FILE RESTART 

FI CLEAR 


PATCHFILE ALL 
SOURCEIN 
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ERROR MESSAGES 


The printout file for CO may contain error messages from the CO utility itself. These are listed in table 6- 
3, and are largely self-explanatory. | | 


Table. 6,-3. Error Messages from CO . 


ERROR MESSAGE 
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First word in Initiating Message is not 2 valic aisk or fil 
name. 

Invatid object program name or compiler rame specified. 
Warning = Compiler Pack Id- truncatec to 7 characters. 
No compiler specified. | 

Warning * Frogram Pack Id. truncated to 7 chérécters. 
Warning = Program Id. truncated to 12 characters. 
Reserved wWorc not found when expected. 

FI/SFILE not followed by one of PATCHF ILE» SOULRCEIN> 
SOURCEOUTs» WORKFILE» PRINTCUT. 

Reserved Worc used out of Context. 

Warning = Compiter Option atready rocifiecd = previous 
mod-+ ignored. 7 

Warnina = Print Option specified more thar orce. 

Record size * Elocking factor > 65535» 8lock size set equal 
to Record size. 

MESSAGE not used by COBOL = Message Text ignored. 
Warning = Message Text atready processed - this 

Message Text ignored. 

This dottar option may not be Set/Reset via the 

Compile Utility. 

SEGMENT filename parameter not a valid file name. 
CO.MASTER no Longer on disk = jot terminted. 

Warning 7 SSEGMENT pack=id trunceteq to 7 characters. 
Warning = S$SEGMENT program“name truncatec to 12 characters. 
S$SEGSIZE parameter not numeric. 

Modification not vatid for SOURCEIN = modification ignored. 
Warning = MESSAGE contains no vatic doilér cérds. 
Aarning = &carda not valid for this compiler. 

Warning - Invalid tcard in Message Text. 

harning ~ PATCHFILE modifications atready dore - these 
mods ignored. 

Warning = PATCHFILE modifications incomplete. 
Modificatior not vatid for PATCHFILE - mocificetion 
ignored. 

Warring @ No PATCHFILE modifications. 

MFIC/FID modification already cone for this file = 

nod ignorea. | 

Fack name/File name in NAME specificétion invalid. 

Pack name in NAME Specification truncated to 7 
characters. 


e 
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File name in NAME specification truncatec to 12 
characters. . 
Pack name in MFID clause invalid. 


Pack name in MFID clause truncated to 7 charécters-. 


File name in FID clause invalia. 

File name in FID clause truncated to 12 characters. 
RECORD size of zero specifiec = mod ignored - cefault 
used. 

DEVICE modification atready done for this file - this 
modification ignored. 

Specified Device Type invalid * de feats device type used. 
FILESIZE atreacy modified for this file - this mod ignored. 
FILESIZE parameter not numeric. 

BLOCK size éelready modified = this wmod. ignored. 
RECCRDS.BLOCK/BLOCK parameter not nuferic. 

RECQRD parameter not numeric. 

SOURCEIN modification already done - these mods ignorea. 
Warning = SOURCEIN modification incomplete. 

No SOQURCEIN modifications. : | 
SOURCEQUT modifications already done = these meds ignored. 
Warning = SOURCEOUT modifications incomplete. 

Warning = No SOURCEOUT modifications. 

Specified RESTART mix*number not numeric. 

specified mix=-number out of range. 

Cannot initiate another RESTART = previous RESTART incomplete 
No CO with specified mix=number available for RESTART. 
Nutt Initiating Message = no file CO.~.STARTUP - job terrinated 
Nested Macro Cait found. 

Invalid file name in Macro Cail. 

Pack name in Macro Catl truncated to 7 characters. 

File name in Macro Calt truncatec to 12 characters. 
Record size for card device > 96» RECORD and BLOCK size 
Set to 96. 

Fite CO.~.STARTUP empty * No Initiating Message = job 
terminated. 

Cannot run CO on this systems» SYSTEM STATUS Communicate 
not supportea. | | 
CO.MASTER not found * job terminated. 

Compiler not zipped - errors in Initiating Message. 
Specified CLEAR mix“number not numeric. 

Specified CLEAR mix-number out of range. 

No CO's to RESTART/CLEAR = job termiratec. 

No CO with specified mix"number éevaitable for Clearing. 
SYSTEM STATUS Communicate failure - job terminated. 
WORKFILE modification already done = this moc ignored. 
WORKFILE not followed by MFID = mod ignored. 

Specified RESTART tine-number for tisting not rumeric. 
Specified Restart Line*nmber > 65525 = Linetnuarber 

Set to 0. | 

RESTART mix*number not specified. 

No parameter specified for CLEAR functior. 

Line"number parameter onty valid for COBCL - ignored. 
lilegal character encountered tn Initiating Message. 
Cannot continue compilation - Compitation Block 


initialized. | | 
79 Non-input Device specified for PATCHFILE =~ mod- ignored. 
80 Non-input Device specifid for SOURCEIN ~ mod- tgnored. 
81 Write"Disabled Device specified for SOURCEOUT - changed 
to Write-enabled. 
82 Non*output Device specified for SOURCEOUT = foc ignored. 
83 BLOCK size for SOURCEOUT is not 2 nultiple of the 
RECORD siZe-e 
BL Specified BLOCK size for Tape Device too targe ~ defautt 
value uSed. | ) 
85 Specified RECORD size for Tape Device too large ~ default 
uSed. 
86 80 col card device RECORD size > 80» RECCRD arc BLOCK 
size set to 80. 
87 96 colt cafd device RECORD size > 965 RECORD arc BLOCK 
size set to %6.- | 
88 Warning - PRINTOUT modification eltready done = this 
fod ignored. 
R9 Device specified for PRINTOUT not Printer Type = ignored. 
99 PRINTOUT not fotlowed by DEVICE - mod. icnored. 
Gi BLOCK size or Btocking7factor of z@ro specifiec - default 
used. , 
92 SOURCEDUT FILESIZE specified as zero = med- ignored = default 
used. | 
93 Specified PATCHFILE FILESIZE > 65525 - default value usec. 
94 Specified SOURCEGUT filesize > 65525 = defautt value used. 
95 Specified RECORD size > 65535 = defarit value used. 
96 Specified BLOCK size or Blocking*Factor > 65535 = defauit 
- used. 
$7 When compiling MPL on Cumbernauld Support System» level 
number required. 
98 If 80 Cole card output device used» record truncation wilt 
occur. | 
99 RECORD size atready modified ~ this mod- ignored. 
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RESTARTING EXECUTING CO VERSIONS 


Note that CO does not prevent restarting or clearing a currently-executing compilation. However, when the 
original version of the compiler pass, that was executing when the RESTART was done, terminates and returns 
to CO, CO will recognize that the block of information in the CO.MASTER file has been overwritten. The 
message 


“CANNOT CONTINUE COMPILATION-COMPILATION 
BLOCK INITIALIZED” 
is displayed and the job is terminated. This may result in problems such as the occurrence of duplicate files. 
If an executing compilation is CLEARed, there is an added complication that any workfiles for that compilation 
are removed. 


Restarting or clearing any currently-executing compilation is therefore not advised. 
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SECTION 7 
NUMBERED SYSTEM SOFTWARE 
OUTPUT MESSAGES 


INTRODUCTION 


The CMS software maintains a table of output messages used by the MCP, the interpreters, and other items 
like the SORT intrinsic. Each of these messages is given a number called the “event number’. The event num- 
ber is always displayed, enclosed in brackets, as part of the message. 


This section lists each message in event number order. 
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EVENTS # 1-9 
Software Information 


These are information indicating error conditions. If any action is required, other message(s) will follow imme- 
diately. | 


Message format: 


mix number/program-name <EVENT #> file-name peripheral function message ERROR WHILE IN verb 
Status. 


The peripheral is given by the mnemonic for example, DK for disk. The function is INPUT or OUTPUT. 


The message is given in the table below. The verb is OPEN, CLOSE, READ, WRITE, etc. The status gives 
additional information such as the disk address for disk failures. 


Examples: 


hy < 46> MYDISK/SYSMEM DM OUTPUT TIMEOUT ERROR 
- WHILE IN OPEN 0033 


10/MYPROG <2>FR203D DM READ PARITY ERROR 
.»- WHILE IN READ 14A5 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


Endina tabelt on tab- None. Froagram has 
eilted tape is missinc indicated it can 
or invalid. handle the error 
itself. 


TAPE FORMAT 


PARITY Hard parity error Nonee Frogram has indic 
<STATUS> found on this ated it can handle 
device. | the error itself. 
<STATUS> shows disk se 
ctor address for disk 
€rrors. 


TIMEOUT For tape device» no Nonee Program has 


<STATUS> data was found for indicated it can 
quite a distance on handle the error 
tape Cexact length itself. 
depends upon unit); <STATUS> shows disk 
For diSk» cytinder cytinder adiress for 
specified could cisk errors. 


not be used. 


Sector Could not be None. Program has. 
found on disk (cyt- indicated it can handle 


ADDRESS 
<STATUS> 


inder was found). the error itself. 
Either software has <STATUS> shows disk 
incicated an invalid sector address for 
sector or sector disk errors. 
address on disk 18s | 


Corrupt. 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


REWIND Problem encount®? Retry the programe 
ered on tape re” 
wind. 


DESCRIPTOR Identifies I/0 error None. Program has 
| that is not PARITY» indicated it can 
TIMEOUT» ADDRESS or handte the error 

REWIND. itself. 


NON@F ILE It is possible for Run $0 utility and 
FULL ON atl entries in avail~ then retry the program. 
MF IO able table (non-fite 

directory) to be in 

use. If a file then 

releases its disk 

space it may not he 

possible to enter it 

in the non-filte 

directory. Disk is 

checkerboarded. 
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EVENTS # 10-19 
Software Suspensions 
When a program that is running encounters a condition that prevents it from continuing, MCP will suspend 


the program and inform the operator as to the reason for the suspension. When the condition is cleared, MCP 
will normally allow program to continue running. If program does not continue automatically then the operator 


Should issue a “GO” command (see “GO” intrinsic) to the program. 
Message formats: 
mix number/program-name <EVENT #> WAITING file-name device message | 


Examples: 


10/LIST <17> WAITING UNLAB LISTPRT AP NO FILE 
10/COPY <17> WAITING TL REEL 001 AT NO FILE > 
02/NGD03 <12> WAITING FILE 255 NO USER DISK 
05/MPL.SEG <10> WAITING CARDFL DF NO FILE 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
19 NO FILE Disk or tape file Check for correct 
| this program needs disk or tape; 
to use cannot be Supply program with 
found. backup copy of file 


vrequested;> 


Programs will continue 
when file is supplied. 


DUPLICATE 


While attempting Normally remove with 


FILE to place a certain RM the existing file 
file on disk» program from diske- Prooram 
has discovered a fite will continue. If 
with the same name in doubt refer to 
atready exists on | program instruct” 
disk. Program halts» TONS 


as 2 files with same 
name cannot resice on 
one disk. 


12 NO USER There iS no more With KA» analyze 


DISK available space amount of available 

on disks or space Space remaining. 

available is If disk is filled 
insufficient to |  femove with RM any 
hold file this unnecessary files 
program is attempt- and program will 
ing to writes or cont inue? 

disk is “*checker- or 


(cont'd) boarded*™. 


POSSIBLE CAUSES SUGGESTED ACTION 


NO USER DISK (cont'd) If disk is filled and 
a dualcopack file is 
desired» assign 
different disk to this 
program (see AD 
intrinsic)», or 
if disk is checker” 
btoarced use SQ ut™ 
ility to consolidate 
disk space» then re- 
execute program that 
encountered suspension. 


13 DIRECTORY When the disk was Remove with RM any 


FULL | initializea the disk unnecessary files and 
directory was const” program will continue, 
ructed to Contain a or OS the suspended 
fixed number of file program. Replace disk 
namese- The directory with another disk 
has now reached its having sufficient dir- 
Canacity- ectory space» and re 


execute the program. 


DEVICE Gutout device that RY required devices 


REQUIRED program needs in order or assign program 
to Continue vorocessing to alternate device 
is either unavailable (see AD intrinsic). 


or not ready. 


FORMS 


Program is waiting Insert correct forms 
REQUIRED for operator to Insert into output device. 

correct forms into the Then use “AD™ intrinsic 

outout device before to assian device to 

it wilt continue pro- program (see AD intrin= 

cessinge s1C)-. 


BAD FILE Specified file Femove with RM 


TYPE type in Disk File file presently 
Header does not on disk. Then 
match that tn prog™ COPY from bac kuo 
ramts Fite Parameter medium the correct 
Block. CAppties only one? or OS the 


to disk files). programe 


17 NO FILE Program needs a. RY required device? 


device that is either or allow program 
unavailable» busy» currently using the 
or not ready. deyice to go to End 


of Job and suspended 
program wilt then aut™ 
omaticatly be able to 
use cevices 
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DUPLICATE 
FILE 


2 or more disks 


Cor tapes) having 
the Same names have 
been found online. 
Onty one disk (Cor 
tape) of a given 
name may be on*tine 
at a time. 


SUGGESTED ACTION 


Check for correct 

disk or tape. 

Replace (Cor retabel) 
one of the duplicates. 


EVENTS # 20-40 
INVALID REQUEST ON CLASS A OR B COMMUNICATE TO MCP 


These messages normally indicate program errors. Program in error should be DS’ed or DP’ed (see DS and 
DP intrinsics), if necessary. Then operator should attempt to run the program again. If the same error is encoun- 
tered, request technical assistance. 


Message format: 


mix number/program-name <EVENT#> CANNOT verb text parameter 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


20 CNULL) Itltegal verb- 


NOT FI8& Byte 1 of Priority A 
or B communicate sh- 
ould contain Data Seg- 
ment Tabte Index of a 
File Information 

Block. Nata Segment 
Tabte does not contain 
Fite Information Etock. 


BAD SEQUENCE Priority A error 
may be noted when 
OPENED I/D with 
Sequential Access 
1- REWRITE was not 
immediately pore- 
ceded by success” 
ful READ. 
?.e OVERWRITE was 
immediately prec- 
eded by OPEN or 
START communicate. 
3. OVERWRITE or 
REWRITE was preced= 
ed by conditional 
READ which failed. 


25 RAD WORK Work Area Seament 
AREA specified within 
| File Information 
Riock cannot be 
useds because it 
either indicates Fi3 
segment or it is Read 
Only segment @ yet 
Communicate requests 
data transfer to 
that segment. 
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MESSAGE SUGGESTED ACTION 
ILLEGAL KEY 


Key requested on 
Priority A comm- 
unicate for a disk 

WaS equal to Zero. 


**NON"RESIDENT COMMUNICATE HANOLER** 


ALREANY OPEN Communicate requested 
an OPEN on already 


opened fite. 


ALREADY 
CLOSED 


Communicate requested 
a CLOSE of atready 
closed file. 


BAD ADVERB Adverb to OPEN was 
determined to be 
itlegal for any 
use of the folloyw- 
ing: 7 

1. MYUSE equal to "9" 
2» MYUSE incompatibte 
with device (for exam- 
ple» I/0 for LP). 

3- Access mode Random 
for non-disk device. 
4. Access mode not 
equal to Sequential 

or Random. 


33 BAD BLOCK OR Record and/or Block 
RECORD SIZE 51ze been determined 
to be incompatible 
or iltegal for any 
of following reasons: 
1- Buffer or Record 
tength equat to zero 
for new disk or tane 
files. 
2- Record tength ex- 
ceeds physical Stock 
S12@.- 
3. Buffer length not 
an integer multiple of 
Record length. 
4. FPB or DFH buffer 
length not multiple of 
180 if old file is 
opened with specified 
Buffer Lenath other 
(cont'd) | than zero. 
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EVENT MESSAGE POSSIBLE CAUSES | SUGGESTED ACTION 


BAD BLOCK OR 5. OFH Buffer length 

RECORD SIZE (cont'd) not muttiple of FPB 
Buffer tength 1f old 
file is opened with 
specified Buffer 

length. 


BAD FILE Maximum file size 

SI 7€ exceeds 104856C or 
65535 if single area 
File. | 


35 BAD NUMBER Number of buffers 


OF BUFFERS specified exceeds 
16. | 


26 BAD DEVICE Nevice requested 
| not supported by 

CMS. Device code 

is illegal. 


BaD FILE 1. An OPEN has been 
TYPE requested on “SYSMEM" 
file by unprivileged 
user program. 

?. Unorivilegced usér 
program requested a 
CLOSE with tock or 
Purge of file with 
SYSMEM VMFILE or 
Firmware File Type. 


38 PROTECTION Privileged user 
ERROR attempted to CLOSE 
with Lock or Purge 
a VMFILE or Firm: 
ware fite white the 
file was stiit in 


uS2@e 
39 BAN FILE~ OPEN or CLOSE has 
NAME detected an iitecal 


special character 
Imbedded in file> 
name e 


BAD KEYSIZE During OPEN of a new 
index filer MCP has 
discovered tn Fite 

Parameter block (FPR) 
a key lenath of zero 
or one that exceeds 

28 bytes. 
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EVENTS # 41-49 | 
Fatal Device Errors 


These messages indicate fatal hardware errors. The program encountering the error should be DS’ed or DP’ed 
(see DS and DP intrinsics) if necessary. Then the operator should attempt to run program again. If the same 


error is encountered the media (disks, tapes, etc) involved should not be used further until field engineering 
has been notified and media has been checked. 


Message format: 


mix number/program-name <EVENT#> file-name peripheral function message ERROR WHILE IN verb sta- 
tus 


The format of these messages is the same as the format for event numbers 1-9. 


POSSIPLE CAUSES SUGGESTED ACTION 


MESSAGE 


DK CLOSE Disk write e@rror 
I/0 ERROR occurred at file 
close time.- This 
could be either 
while writing Last 
blocks» or updating 
Disk Fite Header 

or available table. 


TAPE FORMAT Ending Label on 
tabelted tane is 


missing or invalid. 


PARITY Hard priority error 

<STATUS> | discovered on device. 
<STATUS> shows disk 
Sector address for 
disk errors. 


TIMEOUT For tape devices no 
<STATUS> data was found for 
quite a distance 
on tape Cexact length 
depends upon unit); 
For disk» cylinder 
specified could not 
be found. | 
<STATUS> shows disk 
cytinder address for 
disk errors. 
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VENT 
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MESSAGE 


ADDRESS 
<STATUS> 


REWIND) 


DESCRIPTOR 


POSSIBLE CAUSES SUGGESTED ACTION 


Sector could not be 
found on disk (cyl- 
inder was found). 
Either Software 

has indicated invatia 
sector or sector 
address or disk is 
corrupt. 

<STATUS> shows disk 
Sector address for 
disk errors. 


Problems encount”? 
ered on rewinding 
a tape. 


Identifies I/G error 
that is not PARITY» 
ADDRESS» or REWIND. 
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EVENTS # 50-69 
Load Failures 


These messages indicate that the MCP failed to begin the processing of a particular program for some reason. 
Operator should correct the condition that caused the load failure and then try running the program again. 


Message format: 


[EVENT#] LOAD FAILURE message 


Examples: 


_ [53] LOAD FAILURE NO USER DISK 
[51] LOAD FAILURE PROGRAM NOT FOUND 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


DISK NOT Specified disk Check for correct 
FOUND 7 not online or disk; 
| ready. RY disk if not ready 


PROGRAM NCQT Snvecified file Check Input and rewinpu 
FOUND © was not found if necessary, 
on disk. | Check for correct disk. 


MIX FULL System Cannot accept Allow one program to 


any additional prog” come to End of Job 

rams of this Priority CEON). Then begin 

Class at the moments required program aaain; 
or program presently or DS unwanted prog- 
running will not ram€(s)» if applicable. 
permit any other pro” Then begin required 


grams to enter the mixse program acaain. 


NO USER There is not enough Remove with RM any 

DISK room on disk for unnecessary files; 
this orogram's | 

Virtuat Memory file. 

(VMFILE). © 


INTERPRETER 
NOT FOUND 


For B 80: 


COBOLINT or BILINTERP Supply» with COPY» the 
were not found on sys~ missing interpreters 
tem disk or have bhe- ~~ from backup medium3 
come corrupted. Replaces with COPY, 
| the corrupted inter- 
Ppreters from backup 
medium? | 


7-12 


VENT MESSAGE 


INTERPRETER NOT 
FOUND (cont'd) 


55 USER COUNT 


ERROR 
56 CODE FILE 
ERROR 


INVALID LOAD 
REQUEST 


INSUFFICIENT 
MEMORY 


MCS ALREADY 


PRESENT 
65 DUPLICATE 
DIS 
51 NULL MIX 
REQUIRED 
2007258 


POSSIBLE CAUSES 
For B 800: 


MCP may be corrupted; 


program operator is 
attempting to run 
may be corrupted. 


Too many programs 
are trying to use 
a file. Limit is 
seven. 


Data file name was 
mistaken for program 
name» and an attemot 
was made to run the 
file instead of a 
program. 


Typing error. 

CEX2 too many char- 
acters itn program 
name). 


There is not enougn 
room in memory (to 

hold this proram'ts 

Task Contrct Block 

and Program Control 
Plock). 


OGnty one MCS may he 
In the mix. 


2 or more disks with 
the sam@ name are 
currently on-line,» 
and this system does 
not permit this. 


Specified program 
may be run only 

if no other proarams 
are in the mix. 


SUGGESTED ACTION 


Replace» with COPY, 
corrupted MCP from 
btackuo mediums 
Reoptéece» with COPY» 
corrupted program 
with backup medium; 


Wait until one or 
more Prograns goes 
to ECJ. Then try 
égaine 


Check input and re* 
enter. 


Check input and 
rewerter. 


Request tecrinical 
assistance. 


Rename one of the 
cisks with RLS check 
for correct disk. 


Wait until all 
programs go to EQJ 
before running this 
program. 
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EVENTS # 70-99 
System Errors 


These messages indicate system errors. The program encountering the error should be DS’ed or DP’ed (see 
DS and DP intrinsics) if necessary. Then the operator should attempt to run the program again. If the same 
error is encountered, technical assistance should be requested. 


Message format: 


mix number/program-name <EVENT#> SLICE# message 


EVENT MESSAGE POSSIBLE CAUSES | SUGGESTED ACTION 


SEGMENT OUT Segment number ex 

OF RANGE ceeds number of 
Segments declared 

in the program. 


SEGMENT SIZE Offset and tength 

ERROR value exceeds 
declared size of 
Segment.. 


STACK GVERFLOW Amount of Controt Use MODIFY utility to 
ing a run has exceed=- size of projrams and 
ed declared Stack rerur program. 

$12@- 


73 STACK | Designated code 

UNDERFLOW has attempted to 
retrieve more 
information from 
Control Stack than 

is present. 
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Stack requested dur@ increase control stackl 


EVENTS # 100-169 
Program Errors 


These messages indicate program errors. The program in error should be DP’ed (see DP intrinsics) if necessary. 
The source program, object program, dumpfile produced by DP, and any data files used by this program 
should be saved. The operator should try to run the program again. If the same error is encountered, request 
technical assistance, and supply all relevant data saved to the technician. 


Message format: 

mix number/program-name <EVENT> SOURCE REFERENCING program segment # segment address pro- 
gram counter address message 
Examples: 


03/MYPROG <121> 0 SEGMENT 0 ADDRESS 
15 SUBSTRING ERROR 


04/PROGB < 140> 2639 SEGMENT 18 ADDRESS 
| 436 CODE FILE ERROR 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


*ALL INTERPRETERS* 


109 COMMUNICATE MCP returned 38039 in 
ERROR Byte 0 of Fetch Mess 
age on a communicate. 


COMMUNICATE MCP returned an End 
EOF ERROR of File indication 
in Fetch message 

(220 20 092) and the 
user has not specif 
1ed any action if OF 
occurs. 


192 COMMUNICATE MCP returned I/0 error 
1/0 ERROR indication in Fetch 
message (220 30 00a) 
and the user has not 
specified any action 
to take if error occurs. 


103 SEGMENT NUMBER Interpreter detected 
FRROR an invalid code on 
data seqment number - 


WRITE ERROR Interoreter has detect” 
ed attempt to WRITE 
into a ReadOnly 
Segment or tLiterat-.- 
Code file has become 
Corrupt or an error 
exists tn compiler 

or interpreter. 


2007258 7-15 


SUGGESTED ACTION 


SEGMENT. Interpreter» in cat- 
BOUNDARY culating an address>, 
VIOLATION has discovered that 
the address of the 
data or code 1s out 
of range- Code file. 
has become corrupt 
or an @rror exists 
In compiler or 
interoreter. 


** INTERPRETER for MPLII** 


110 INVALID OP Code file has become 
Corrurt or e@rror exists 

in MPLITI compiler or 

Interpreter. 


115 DESCRIPTOR Program tried to store 
ACCESS CONE the fetch value to 4 

nonwcharacter fietada» or 
to convert to a non- 
character field» or. 
to store to a setf- 
relative descriptors 
or an error in the 
SETNAME procedures or 

a decimal add error. 


SEGMENT SIZE Segment Length is 

ERROR too tong or is set 
while seoment is 

in core. 


SETNAME extent errors 
tdentifier has become 
out of scone 


ADDRESS ERROR 


MESSAGE Message reference 
REFERENCE field not divisible 
ERROR by 4 or illegal 
access to message 
reference Space. 


Illegal destinat- 
Ion tn Store string 
instruction. 


STRING STORAGE 
ERROR 


120 REMAP ERROR Program tried to remép 
a bit descriotor. 
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EVENT MESSAGE POSSIBLE CAUSES | | SUGGESTED ACTION 


SUBSTRING Attempt made to sub- 
ERROR string into non*char* 
acter area. 


INDEX ERROR Program tried to 
Index a self-relative 
descriptors? or to bit 
index a Selfrretlative 
descriptor. 


EXIT ERROR locat data returned 
from a function. 


CPA ERROR Frror in communicate 
parameter area: for 
example» message ref- 
erenced exnected» or 
size of character 
field at teast 3 
bytes expected. 


DIVIDE ERROR Divide by zern 
attempted. 


Error returned after 
ZIP Cnot used on 829) 


DESCRIF- Bit fietd overtaops 
ERROR more than one byte 


Error in file para- 
meter DlLock e@ncCount” 
ered - subfield of a 
nonw*F.P.8. segment 
requested. 


CONTROL STACK Control Stack over= 
FRROR | flow or underflow.e 


DATA STACK Ittlegat descriptor 
ERROAR encounter ‘ 


NDECLARATICON Size of character 
MODE ERROR fietd greater than 
256 | 


DATA STRUCTURE Insufficient room for 
ERROR structure nesting or 
S$iZe of character 
field greater than 255>» 
or insufficient roor 
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EVENT MESSAGE POSSIBLE CAUSES _ SUGGESTED ACTION. 


BATA STAUCTURE for array bound evat- 

ERROR (contd). uations or none-char- 
acter descriptor enc” 
ountered when charact- 
er descriptor expect” 
ed. 7 


BOUND EFRROR Same aS event 136 
Cused on 8800) 


ARRAY BOUND Error in indexing 
ERROR | arrays out of range 


DO LOOP Error in DO or UND} 
ERROR Statement | 


139 CASE ERROR Frror in CASE statement 


** INTERPRETER for CO80L and RPG** 


1490 COOE FILE Invalid S-Sp-Code. Same aS event 143 
ERROR Code file is Corrupt 


or error exists in 
CO30L/RPG compniter 
or interpreter. 


141 CODE. FILE Invalid COPX = greater Same as event 142 
ERRAR than size of COP table. 
Code file corrupt or 
error in COBOL/RFPG com- 
piler or interpreter. 


142 CODE FILE Atphanumeric fietd Same as event 143 
ERROR tyoe not 8ehit un- 

signed. Code file 

corrupt or error 

in COROL/RPG com- 


piter or interpreter. 


143 CODE FILE. - Invalid EDIT micro Resrun orogram from 


ERROR Oper ator- Code file backup copy. If stilt 
corruodt or e@rror In in errors request 
COBOL/RPG compiter technical assistance. 


COBOL/RPG compniter 
or interpreter. 


CODE FILE Intine EDIT MASK Same as event 143 
ERROR not correctly ter™ 

minted. Code file 

corrupt or error in 

COBOL/RPG compiler 


or interpreter. 


EVENT MESSAGE POSSIBLE CAUSES | SUGGESTED ACTION 


CODE FILE EXAMINE source fietd 
ERROR error. Code file 
corrupt or error in 
COBO0L/RPG compiler 
or interpreter. 


Sam@ as event 143 


146 CoDE FILE EXAMINE parameter. Same as event 143 
ERROR field not 8-hbit 
unsigned character. 
Code file corrupt or 
error in COBOL/RPG 
compiler or inter- 
preter. 


CODE FILE EXAMINE control byte 
ERRO errore Code file corr 
upt or error itn COS80L/ 
RPG compiter or inter 
preter. 


Same 


CODE FILE COMPARE for CLASS>=- Same as event 143 
ERROR CLASS and FIELD type 

incompatibte. Code 

file corrupt or error 

in COROL/RPG compiter 

or interpreter. 


SUBSCRIETED OR 


Code file corrupt or 


INDEXED error in COBOL/RPG 
SUBSCRIPT OR Compiler or interp- 


INDEX | reter. 


PERFORM STACK Indicates too many The size of the perform 


OVERFLOW PERFORMS without a Stack may be increased 
return for the by the MODIFY utility» 
Perform Stack spec- uSing the CONTROL.STACK 
ified at compile option to change the 
time (Cif not spec- PPB (see section 4). 


ified then the de- 
fautt value was used). 
If this did not 

result from a progran- 
ming e€rror»s the 
Perform Stack should 
be increased. 


NON“POSITIVE Sudscriots must be 
OVERFLOW positive. 


162 ARRAY BOUND Subscripts outside 
: VIOLATION upper bound of 
| NCCURS Clause. 
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MESSAGE | 
TRANSLATION 
SOURCE ERROR 


INVALID SIGN 
CODE 


POSSIBLE CAUSES 25 


‘SUGGESTED ACTION 


EVENTS # 170-199 
SORT Exception Events 


Any of these output messages may be displayed while SORT and SORTINTRINS are running. For reporting 
SORT errors: all SORT errors should be accompanied by either the Sort Spec or the COBOL program that 
requested SORTINTRINS, as well as the input file(s). Since SORTINTRINS is a machine-dependent program, 
the method of getting a dump may vary. To get a program dump on the B 80: rerun the program with “GT” 
on. This will cause SORTINTRINS to dump its run structure on the console printer. 


Message format: 


mix number/program-name <EVENT#> message 


POSSIBLE CAUSES SUGGESTED ACTION 


DUPLICATE 


Only for Key file If dupticates are 


RECORD record creatione Another desired» snecify 
number record in file has "QUPLICATES™ jin 
same key as this input. 


record. 


ILLEGAL INDEX Onty for keyfitle 
KEY IN RECORD £creation.e Either 
record number the Key fietd is 
all binary 0 or 
has one or more bytes 
With hex FF. This 
record wilt not be 
referenced from tha 
keyfitle. 


RECOROSS LOST Probably indicates an see introductory 
OR GAINED 8Y error in SORTINTRINS. paragreéeoh concerning 
SORTC*MRERGE errors. 


173 numper Normal message tells None. 
DUPLICATE the opertor the total 
RECORDS number of records 


that have duplicates. 
(See Event 170). 


number RECQRDOS Normal message tetts 


CONTAINING operator totat number 
INVALID INDEX of records with in- 
KEYS valid index keys. (See 


Event 171 for further 
informatior). 


number Records with hex FF 
RECIRIS in every byte position 
DELETED will be deleted by 
SORT. Informs operator 
how many records were 
deleted. 
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MESSAGE POSSIBLE CAUSES | SUGGESTED ACTION 


nuaber Normal message for 
RECORDS | MERGE only. Tetts op- 
MERGED erator total number 
of records merged 
from all files. 


number FILES 
MERGED 


Normal message for 
MERGE onty- Tells 
total number of files 
mergede- Should be 
same as number of 
files requested in 
the Sort Specs. 


178 SORT “MERGE SORTINTRINS was OS'ed; See introductory 
OUTPUT FILE may indicate corrupt Paragraph concerning 
NOT CREATED SORT or SORTINTRINS SORT errors. 

programs. 


SORT “MERGE Early termination due 
ABNORMAL to errors. 
EQJ 


SORT“MERGE Error in SORTINTRINS See introductory 
SOFTWARE paragraph concerno- 
FRROR ing SOFT errors. 


number Onty for keyfitle- 


RECORDS tagfile creation. 
REFERENCED Tetts number of ent- 
BY KEYFILE™ ries of keyfite/ 
TAGFILE tagfile. 


182 NO INITIAT= SORT INTRINSIC requir= None. 

ING MESSAGE es a property coded 
Initiating Message. 
This should be prop" 
erty formatted by 
SORT or Sorts within 
programming languages 
such as COBOL. Probab: 
ly indicates an att™ 
empt to execute SORT 
INTRINS directty-. 


number Normat message telts 
RECORDS number of records 
SORTED | sorted by the SORT 

| utility. SORT succ- 


essful- 
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EVENT 
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MESSAGE 


FILE ERROR 
<number> ON 
SORT*MERGE 
FILE file- 
name 


UNORDERED 
MERGE INPUT 
MERGE FILE 
filename 


MERGE 


DUPLICATE 
RECORDS - 
KEYFILE NOT 
BUILT 


INIT MESSAGE 
INV ALIO 


SOUR T*MERGE 
INITIATED 
FROM mix 

number/prog- 
ram"“name 


TOO MANY REC- 
ORDS FOR SORT= 


POSSIBLE CAUSES | SUGGESTED ACTION 
The <number> means: 


see introductory 


1. EOF on output File Paragréeph concern= 
2e PARITY on Input ing SORT errors. 
File 

3- EQF on Sort Work- 

file 


4. Sad Disk Address 
S- SORT workfite Error 
6. Input Fite fFrror 
‘. Outout Fite Error 
Except for 2.5 this 
probably indicates 
error tn SORTINTRINS. 


Files to be merged files for order. 
were found not to be Then retry. 
increasing/decreasing 

key value. Either the 

file is incorrect or 

the key position has 

been incorrectly sne- 

cified. 


Machine=dependent See introductory 
Limitation. Paragraph concernina 
SORT errors. 


Was not specified Specify DUPLICATES 
anc duplicates exist. im trout. 

The keyfile will not 

be buitt and this 

message wilt be 

disolayed. 


Initiating message see introductory 
to the SORTINTRINS Paragraph concerning 
1s not in proper SORT errors. 

format. This coutd 

Possibly be caused 

by a fautt in the 

Proqram that zipcved 

the SORTINTRINS. 


Informs the operator 
Which Pprogfam uSea 
the SORT intrinsic. 


SECTION 8 
B 80 DEPENDENT SYSTEM SOFTWARE 


INTRODUCTION 


This section covers those items in the CMS software which are operationally different on the B 80 from other 
CMS implementations. These differences are mainly a result of the different hardware features involved. The 
software covered includes: 


Powering the B80 on and off. 

The B 80 CMS disk “bootstrap” feature. 
Stand-alone utilities, operating without MCP control. 
Loading the MCP. 

Particular features of the B 80 MCP. 

Taking memory (system) dumps. 

Utilities released only for B 80 systems. 

B 80 system errors and symptoms. 


POWER ON 


Assure no disks or cassettes are in the system (failure to do this may result in subsequent media corruption). 


Turn the system power on. It is then under the control of ROM which performs a mini-test of critical machine 
components to verify it is capable of starting. The successful completion of this test is verified by the PK lights 
lighting and then turning off sequentially, with PK1 and PK2 remaining lit. 


PK1 permits the loading of a cassette into the system. Some examples of cassettes to load would be (1) AE 
500 firmware to cause the B 80 to perform as an AE 500, or (2) ACSYS SL5 emulator firmware cassettes to 
cause the B 80 to process Series L cassette programs on disk. B 80 cassette loads are not used in CMS. 


PK2 permits the loading of information from a disk into the system. Some examples of disks to load would 
be (1) ACSYS (SLS emulator) firmware disks, or (2) CMS disks to cause the B 80 to load CMS firmware. 


Load the CMS disk in any available disk drive. 


A mini-disk is considered loaded immediately the drive unit door is closed, and the blue indicator is lit (disk 
properly inserted and up to speed). For MCP control the disk must be write-enabled (red indicator lit). 


For cartridge disk, wait about 20 seconds for the cartridge to come up to speed (you hear a click as the heads 
access the disk). Ideally they should be run initially for a few minutes before use to achieve correct running 
temperature. For MCP control the disk must be write-enabled. 


Depress PK2 to enter CMS Bootstrap Mode (see below). The various States, including Initial State and Boot- 
strap Mode, are shown in Figure 8-1. 


Possible errors in power-on sequence are given below, System Load Errors. 
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POWER ON, OR 
DEPRESS LOAD ENABLE BUTTON 


INITIAL STATE 


ACTIVATE 

CASSETTE 

BOOTSTRAP 
IN ROM 


ACTIVATE DISK 
BOOTSTRAP 
IN ROM 


(NOT USED 
BY CMS) 


ACSYS CMS 
DISK DISK 
SEE PRESENT PRESENT 


ACSYS 
DOCUMENTATION 


PO SYSTEM 
DISK CMS BOOTSTRAP MODE 


OR 
FATAL 
ERRORS 
MCP | 
WARMSTART | MEMORY. a 
MEMORY noe LOAD 
DUMP Bee STAND—ALONE FUNCTION 
UTILITIES 


TO 
CASSETTE (SAU) 


Figure 8-1. B 80 Coldstart And Warmstart 
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CMS BOOTSTRAP MODE 


From the Initial State, depression of PK2 initiates a ROM load routine which searches through all present 
disks until it finds the bootstrap code. 


Successful load of CMS bootstrap: PK3 through PK6 will be lit, to provide the following facilities: 
PK3 — warmstart the MCP. 
PK4 — dump contents of memory to cassette. 


PKS5 — dump contents of memory to disk. 
PK6 — enter stand-alone utilities (SAU). 


Note: 


The search for a bootstrap code precedes as follows: 
bottom drive of highest-channel disk unit 
top drive of highest-channel disk unit 


bottom drive of lowest-channel disk unit 
top drive of lowest-channel disk unit 
and stops at the first bootstrap, whether a CMS bootstrap or ACSYS bootstrap. For example, if there is one 
cabinet with two cartridges, DKA and DKB, then DKB will be searched first. If there is more than one disk 
cabinet, you can find the channel address from the field engineer. 


A Note on Forcing System Initialization 


When the system hangs (that is, it is not performing any functions or responding to any input from an 
operator, but has not returned to the initial state), it is necessary to force the system to initialize. 


This is done by depressing the Load Enable button in the main cabinet. Never switch the cabinet off, or un- 
load disks or cassettes in use, as this can cause media corruption of various kinds. 


If the correct procedure is followed, then although disk or cassette files may be only partially created or up- 
dated, the system when recovered should be still able to access the media. 
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STAND ALONE UTILITIES 


The S.A.U process has the necessary functions to prepare a disk for use on the B 80. This process is used 
to initially transfer system software (MCP, interpreters, compilers and utilities) to a new disk at a new installa- 
tion, or to install a new level of MCP at an existing installation. It is also used to condition new disks (IN 
Initialize) or recondition (RF reformat) existing disks for copying on the B 80. 


The S.A.U functions are brought into memory from disk and operate independent of the MCP. 


Loading Stand-Alone Utilities 


The system must be in the CMS Bootstrap state. If the system is in the initial state, depress PK2 to get to 
CMS Bootstrap State (PKs 3 through 6 lit). | 


Depress PK6. System will search disk (from which bootstrap was loaded) for a file called SAU. 


If this disk does not contain SAU, then any disks (containing bootstrap files) located on a lower channel will 
also be searched. For each disk you must depress PK6 until search is complete. 


(For failures in search see below System Load Errors). 


Verify by a printed message that the S.A.U has been loaded into memory from disk. 
| STAND-ALONE UTLITY 
VERSION n.nn.nn | 
REQUEST “HELP” FOR FUNCTION SUMMARY 
FUNCTION | 


Functions Available 


initialize a disk: IN 

reformat a disk to the initial state: RF disk-name 

load files to disk from cassette: LD disk-name FROM 
| cassette-name 

copy files from disk to disk: COPY disk-name/file-name 
| TO disk-name/file-name 

remove disk files: RM disk-name/file-name | 

list the disk files and their sizes: LS disk-name 

relabel a disk: RL disk-name 

list status of drives: OL 

warmstart the MCP: WS 

initialize a disk for MTR use: FE (field engineers’ use) 

terminate stand-alone utility execution: PO 

clean BSM disk drive read/write heads: CLEAN 


When the Stand-Alone Utilities are running, only the ON light is lit. Each of the utilities is initiated by a 
command on the Alpha Keyboard. Only one utility may run at a time and keyboard input is valid only when 
no utility is running. Keyboard input entered while a utility is running will be lost except for the first four char- 
acters. The reset key will clear all keyboard input since the last OCK key, and any OCK key will terminate 
keyboard input. : 


Common S.A.U.. Output Messages 


{MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


FUNCTION ABORTED Hardware error. Notify field eng- 
ineer. 


Dxy DEVICE ERROR Specified drive was Ready drives or 

DEVICE INOPERABLE accidentally made notify field engineer. 
| Not Ready; or drive 

unit matfunctton-.- 


Oxy DEVICE ERROR 
OFF CYLINDER __. - oo : pases rr ee nade. e 
Oxy DEVICE ERROR Disk in specified Ensure that the Write 
WRITE INHIBITED drive has its write Lockout Hole (BSMD) 
lockout indicator is covered» or for 
Set. cartridge ~- the Write 
Lockout Plua is flush 
with surface of 
cartricge. 


Drive unit malfunc- 
_tion. 


Nofity field engineer. 


Dxy DEVICE ERROR Drive unit matlfunce> 
ISEEK TIMEQUT Ton 


Notify field engineer. 


Dxy DEVICE ERROR Drive unit mat funct- Notify field engineer. 
CONTROLLER PROBLEM tion 


FUNCTION 


Prompt to reauest Jop- Enter rext function» 
erator to enter next or “HELP® to display 
desired function. List of functions. 


Note: 
x identifies type of disk 
(M = BSMD, F = FIXED, K = CARTRIDGE), 
y identifies unit 
(A, B, C, etc.) 


Disk I/O Errors During S.A.U. 
These errors are identified by the messages: 


O/P ERROR, I/P ERROR, <unit> DIRECTORY I/O 
ERROR, <unit> DEVICE ERROR 


which may be encountered while running the Stand Alone Utilities. 
Disk I/O errors indicate a failure to read from (I/P error) or write to (O/P error) disk. Such problems should 
not be allowed to persist on a disk which is to be used to store important information, especially where the 


disk is to be used as a systems disk. Therefore an explanation or fix is required before the drive and disk can 
be considered acceptable for live use. Even if the Stand Alone Utility continues to run satisfactorily, there may 
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be some form of disk corruption. After any of these errors, the media involved should be checked for any cor- 


ruption which might cause future system problems (for example, the CHECK.DISK, KA, or DA utilities under 


MCP control). 
A Note On Dual Pack Files 


A “dual pack file” is a file which resides on two separate disks or logically identified disks (for example, 
DFA and DFB). 


A dual pack file consists of: 
A disk file header on each of the two disks. 
At least one and at most sixteen file areas, each of which may be allocated on either disk. 


Both parts have the same file name. 
Under MCP control, the file may be opened only if both parts are present. 
Each file header contains a reference (the pack-id) to the other disk. 


Therefore if for any reason one part of the dual pack file is lost, or if the pack-id of one of the disk volumes 
is changed, the file will be inaccessible under MCP control. 


part of a dual pack file. Dual pack files may be located with the LS function. 


Therefore caution must be exercised when using SAU to initialize, reformat, or relabel any disk containing 


In addition to the file-name and area occupied, the LS function will give, for each dual pack file, and overflow 
pack-id and the total overflow area. | 


If one part of a dual pack file is lost for any reason, the S.A.U. RM function may be used to remove the 
remaining part. | | 


The terms “master file’ and ‘overflow file’ are sometimes used to distinguish the two parts of a dual pack 
file, however it should be borne in mind that either part of the file may be regarded as the master file. In 
this section the term “master” file is used to indicate the part of the file mentioned in a COPY or RM com- 
mand. 


8—6 


CLEAN (Clean BSM Drive Read/Write Heads) 


The read/write heads of the one megabyte mini drive are cleaned by this function. This cannot be used on 
any other type of drive. Each head is cleaned in turn by the Burroughs head cleaning diskette. 


The ‘procedure the system follows to clean one head is as follows: 

Load head onto cleaning surface. 

Sequentially access the disk from the outermost track to the innermost. 

Sweep heads from the outer to the inner-track and back, ten times. 

Unload head. 

The current position of the head on the disk is visually displayed by illuminated PK lights. 


Example: | 


CLEAN 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


Prompt requesting Ptace cleaning disk 


operator to insert into proper drive. 
cleaning disk into Make certain disk is 
proper drive. write inhibited (write 


inhibit hole is covered 
and is positioned at top 
corner of disk). 


LOAD WRITE INHIBITED Cleaning disk was Enter "OK" olus OCK1 
CLEANING DISK AND Inserted into te start cleaning 
TRANSMIT “OK"™ TO drive. erocedure; or press 
CONTINUE CCKL to terminate the 
function. 


HEAD 1 CLEANED. Head 1 has been Turn @ick us side. doun 


FLIP WRITE INHIBITED cleaned. Cwrite inhibit hote 
CLEANING DISK AND to bottom) so that 
TRANSMIT "OK" TO cleaning surface faces 
CONTINUE. other side;? then enter 


"OK" and press OCK1 to 
tegin cleaning funct= 


TONS o 
HEAD 9 CLEANED Both heads have Remove cleaning disk 
FND CLEAN been cleaned. Func: and store. 


tion endse 


Any attempt to clean head 0 before head 1 will result in the “LOAD/FLIPDISK”’ message being prompted. | 


WARNING 
Any attempt to use a write-enabled disk or any disk other than the cleaning disk 
during execution of this function will result in serious damage to the disk drive. 
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COPY (Copy files disk to disk) 


This function allows the operator to copy files from one disk to another. Overflow files will not be copied. 


- Format: 
file-name or 7 | 
COPY disk-name . / group-name TO disk-name 
Examples: 


To copy a single file: 
COPY PR1/PR200 TO PRBU/PR200 


To copy a group of files: 
COPY PR1/PR= TO PRBU/PR= 


To copy all files on one disk to another: 
COPY PR1/= TO PRBU/= 


To copy a file and change its name: 
COPY PR1/PR200 TO PRBU/PR200B 


Output messages: 


MESSAGE | | POSSIBLE CAUSES 


file-name or 
/ — group-name 


SUGGESTED ACTION 


DUPLICATE FILE NAME = System detected a file 
name on disk tdentical 
to that which the op- 
erator 1S attempting 
to copys No two files 
with the Same name 
may reside on a diske 
Therefore specified 
file was not Copted. 


filename TOO LARGE Insufficient avail- 
| able space on dest~ 
ination disk for thre 
specified file to 
be copied. 


NAME LIST FULL When this disk was 
| initialized» the disk 
directory was const*™ 
ructed to contain a 
fixed number of file 
names. The directory 
| | has now reached its 
(cont’d) capacity. 
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Normally» remove 

the existing file 
with RM> reattempt 
the COFY. Check input 
for correct spec= 
ification of file 
namese 


Use a different disk» 
or first remove some 
files using the RM 
function. 


The COPY function ends 
automatically. IF 
possibles remove with 

RM any unwanted file(s) 
to make room in the disk 
directory. Then re- 
attemot to COPY the file 


which encountered the 


errors — 


NAME LIST FULL (cont'd) 


A read or write error 
was encountered white 
the system was attemot- 
ing to access the dir 
ectory of the specifi= 
ed disk. The directory 
structure of the 
(source) disk may be 
corrupted. 


Dxy DIRECTORY 
I70 ERROR 


OovP or1sk IS NOT 
WRITE PERMIT. 


Destination disk 
(disk to which 

is copying 
inhibited. 


file*name NOT FOUND 


Specified filename 
is not on disk. 


PACK disk-name NOT Specified disk 
not online to the 


comouter e 


Replace the : 
cisk that has sufficient 
room tin the disk direc 
tory. 


1.Change the position of 
the agisks and retry. 
ceFor &@ group copys» some 
files may be recovered 
using sinata fite copy. 
If these attempts fail 
then type of error 
Should be analyzed with 
DA utility and disk 
re~initialized before 
re"useée 


For cartridges: ass 
certain that write 
Lockout pluj 1s. 
flush with outer 
surface of cartridges 
For BS*D: ascertain 
that the write tockout 
hole 1s covefed; 

Retry the COPY. 


Check input “™ reenter 
if necessary» 

Check for correct 
cisk. 


Check input = revtenter 
if necessary, 

Check for Correct 
disk. 


INVALID REQUEST ‘Typing error. 


Copy successful CENI)3 
Specified group name 


to be copied 


filestname COPIED COPY successful 


CANNOT ALLOCATE 
AREAS FOR 


Insufficient avyail- 
able sdace on disk 
to which operator 
attemoting te Copy 
‘this file. 


Check tnput and rem 
enter. 


None if copy successful» 
Check input - revwenter 
lf necessary, 

Check for correct diske 


NONE 


Usinc KA utility» 
analyze disk avait- 
able Space. 


O/P ERROR = file- €rror encountered Allow COPY to continue 


name white system was att™ copying any remaining 
empting to write | files. Then reattempt 
specified fite to copying the file in 
disk. atts which the O/P error 


cccurfrede 


I/P ERROR = file- System encountered Atlow COPY to continue. 
name errors in the file Then use backcupd copy 
| from which it was of the specified file 
reading. | and revattempt the 
| COPYs switch the disks 
to the opposite drives. 


file-name NOT COPIED: Specified filename Creck input and recenter 
ILLEGAL FILE°ID: contains an illegal 1f necessary. 
character (that is» 
/ 2)» therefore file 
wiit not be copied. 
Legal characters are 
0-9» Aw~Zse « (dot)>» 
- (dash). 


file-name COPIED: DisSk=to-disk copy is 

ILLEGAL FILE?ID being made and this 
warning is given that 
the new file 1s copied 
but with an invatid 
filename. 


Dual Pack Files | 


The copy function cannot create a dual pack file, however a complete dual pack file may be copied to a single 
disk. | 


The master file will be copied first. COPY will then look for a matching overflow file on the overflow pack. 
If a matching overflow file is found it will be copied and the function will terminate with the message: 


filename COPIED FROM disk-name-1 AND disk-name-2 


__ If the overflow pack is not on line or the overflow file is not found or an overflow file is found which does 
not match the master file, the function will print the following message, and wait for operator input: 


disk-name-file-name IS AN INCOMPLETE DUAL PACK FILE 
A MATCHING OVERFLOW FILE ON disk-name-2 IS NOT PRESENT. 
PLEASE TAKE ONE OF THE FOLLOWING ACTIONS: 
A. SUPPLY THE CORRECT OVERFLOW PACK AND 
TYPE “A” TO TRY AGAIN 
B. TYPE “B” TO SKIP THIS FILE 


At this stage the master file pack may be removed if necessary. 


The operator should either power on the correct overflow pack and type “A” followed by OCK1 or type 
“B” followed by OCK1. | | | 
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\ 


If the “A” option is selected the function will repeat its search for the overflow file as above and either ter- 
minate normally or repeat the prompt to the operator. 


If option “B” is selected the output file will be purged and the function will terminate with the message: 
fileename NOT COPIED, PART OF A DUAL PACK FILE 


WARNING 
If a level of SAU earlier than 3.00 is used to copy a dual pack file or a family con- 
taining a dual pack file, the output disk is liable to be seriously corrupted and to 
require re-initializing. 
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FE (Initialize MTR Disk) 
A virgin or a formatted disk is initialized to CMS format with suitable sectors reserved for MTR test routines. @ 
(These sectors will be denoted as BAD sectors on a KA map of the disk). The surface is checked by writing © 
and reading test patterns to each sector. Bad sectors and the MTR tracks are made unavailable. A disk label 
_ Is written and the file directory is created with a single, SYSMEM, entry. Sectors 1 through 31 are loaded from 
a file called “CMSBOOTxxxxx” which can be contained by any on-line disk or by any cassette labelled 
_“SYSB80” which has “CMSBOOTxxxxx” as its first file. 


The “‘xxxxx” characters are ignored by the utility; only the seven leading characters are compared when the 
on-line disks are searched (that is, the file specifications searched for is equivalent to CMSBOOT=). 


In the case of fixed disk, the CMS bootstrap will be loaded from CMSBOOTxxxxx. All other disks initialized 
by FE will extract the MTR bootstrap. 


The MTR tracks will not be included in the number of bad sectors, but if the disk is reformatted (see RF), 
the total number of sectors removed from the available table will be referred to as BAD. 


Example: 


FE 


Output messages: 


POSSIBLE CAUSES 


SUGGESTED ACTION 


Prompt allowing entry Enter rive 

of drive where disk Cex: DKA» DMB» atc) 
to be initiatized is 

Located. 


Enter date 
(format MM/DD/YY) 


Prompt allowing entry 
of initialization 
date. 


SERIAL 


| PACK 


ICWNER 
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Prompt atlowitng> 
entry of maximum 
number of files 
for this disk. 


Prompt allowing 
entry of disk serial 
number. 


Prompt allowing 
entry of disk name. 


Prompt allowing entry 
of userdefined in” 
formation. 


Enter Maximum number — 
of files this disk will 
contéin Cless than 
255). 


Enter serial number 
(6 numerats). 


Fnter disk-name 


(up to 7 teagal charact- 


ers) 

Legal characters include 
C99 Awl» » Cdot)» 

= (dash). 


Enter vatid inform=- 
ation up to 14 


characters). 


Prompt requiring res- 
ponse of “N*™ at this 
time. 


RESTRICTED | 


BOOTSTRAP VERSION FE CEOJ) 
nennenn USED END 


FE 


NO OF BAD Disk was successfully 

SECTOS number initialized. If any 
bad sectors were dete~ 
cted the number is 
displayed. 


Sector(s) in Track Select another disk 
OQ are bad and cannot to be initialized 
be used. FE wilt end» with FE. 

as a3 CMS aisk must | 

contain reserved 

information in Track 

0 Cex? warmstart 

bootstrap). 


TRACK 9 BAD 


SYSB80 NOT PRESENT System faitea to find Load another drive with 
LOAD CMS BOOTSTRAP a bootstrac file from a disk containing 
AND HIT OCK1 TO either disk or cass CMS8COT or toad a 
CONTINUE ette cassette with name 
| SYS880O containing 
CMSBOOT. 
Then press OJCKi. System 
will rectattempt search 
for CMSBOCT. 


BAD MTR TRACK 


Any MTR track contains 
a bad sector. 


CYL xxx BAD In cases where certain Select another disk 
cylinders are used for to be initialized 
MTR purposes Dut not by FE. 
removed from the 
available tabte dis-™ 
covery of a bad sec™ 
tor will terminate the 

function. 
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IN (Initialize a Disk) 


The MCP (Master Control Program) requires that any disk to be used on the system have a valid CMS disk 
label, disk directory, and available area table. In addition, each sector of the disk must be initialized with its 
address. | 


The IN function performs this disk initialization. It will check the recording surface of each disk by writing 
and reading test patterns to each sector of the disk. Any “bad sectors” (unusable or unreadable) will be re- 
moved from the disk’s available area table, and the number of bad sectors will be displayed to allow badly worn 
disks to be discarded. © | | | 


The function will also write a disk label containing information supplied by the operator to the appropriate 
prompts, below, and create a disk directory of the appropriate size required for the number of files specified, 
plus a single, SYSMEM, entry. Sectors 1 through 31 of the disk are loaded from a file “CMSBOOTxxxxx” 
which may be located on any on-line disk or on any cassette labelled ““SYSB80‘ which has “CMSBOOTxxxxx” 
as its first file. Before loading can take place, the correct identification string must be found in sector one of 
this file, namely, BBODISKINITVAOF. The disks are searched in descending order, cartridge disks first, then 
a further scan of Burroughs Super Mini Disks. | 


Since all fixed disks must be suitable for MTR purposes, the functions IN and FE are identical in this 
particular case. The relevent MTR tracks will be checked and/or removed and the CMS bootstrap is written. 


Example: 


IN 


Output messages: 


MESSAGE | POSSIBLE CAUSES SUGGESTED ACTICN 


~—6fisk Was successfully 
initialized. If any 
bad sectors were det- 
ected the number 

found is displayed. 


NO OF BAD SE 


CTGRS 
number 7 


BOOTSTRAP VERSION IN successful (CEO0J). 
neonnenn USED END 


IN 


SYSB80 NOT PRESENT system failed to Load arother drive 


LOAD CMS BOOTSTRAP find bootstrap file with a disk containing 
FILE AND HIT OCKi1 on disk or casSette., CMSBCOT or toad ato 
TO CONTINUE. cCassete with name 


SYSB80 containing 
CMSBCOT as its first 
file. Then depress 
Cassette» then oress 
OCK1-. System wilt rem 
éttempt search for 
CMSBOOT. | 
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TRACK 90 BAD Sector(s) tn Track 0 Seltect another disk 
are bad and cannot to be tnittalized. 
be used. IN witt ters 
minate» as a CMS disk 
must contain reserved 

information tn track 

0 Cex? warmstart 

bootstrap). 


Prompt allowing 
entry of drive in 
which disk to be 
initialized 1s 

ifocated. 


fFnter drive (Cex: 
DKBs DNA» etc.) 


Prompt allowing Enter cate (format 
entry of inttiatiz- MM/DO/YY for months 
ation date. day»years eege 01/23/79) 


Prompt allowing entry Enter number of files 
of maximum number of cisk witl contain 
files for this disk. (tess than 255). 


Prompt allowing Enter serial number 
entry of disk serial (6 numerats).- 
number. 


Fnter diske*name 
(up to 7 characters). 


Prompt allowing entry 
of disk namee 


Prompt atlowing Enter any valid 
entry of user-defined information 
information. (up to 14 characters). 


RESTRICTED Promet requiring Enter “N“. 
response of “N™ at 


this time. 
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LD (Load Disk) 


This function allows the operator to load all files from a dump tape to a disk. A dump tape is one produced 
by the DUMP or UNLOAD functions of the utility “LD”. (which run under MCP control). Each sector of 
data written to disk is verified. The S.A.U LD function cannot create a dual pack file. : 


Format: 


LD disk-name FROM _iibrary-tape-name 


Example: 


LD ARDISK2 FROM ARTAPE 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


filename LOADED Disotayed for each 


file toaded and 
verified. 


LOAD REEL number Dump tape is a reel Supply next reet. 
from a multiv~reel 
dump and the next 
reel tS required. 


END LD | LD CFOY) | None. 


NOT DUMP TAPE | Specified tape 15s Supply correctly 
not a correctly formatted dump 
formatted dump tape. taper reinitiate 
Function ENDS. LO. 


Specified tade 1s Instattl and ready 


multi-file-name 


NOT PRESENT. LOAD not instattled and taper re"initiate 
CASSETTE AND HIT ready? Function ends. LD> or press OCKi 


THEN DNCK1 TO TER- | | multitreel name 
MINATE. tape*> cer press any 
key plus OCK1 to ter 
minate LD. 


UNRECOVERABLE Error was encounter- Ready cassette drive 
1 CASSETTE ERROR ed while system was unit’? re"initiate 

: attempting to read ‘LD. 

cassette. Normally 

Caused by accidentalty 

opening cassette drive 

unite Function ends. 
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PACK disk“name | Specified disk is not Ready the disks 


NOT FOUND ready? specified disk Check for correct 
is not on-line to con= disk. 
putere 
D/P DISK NOT | Disk to which files Ensure that write 
WRITE PERMIT. are to be loaded tockout hote is 
| is write protected. covered (for BSD)» 
Function ends- for cartridge - ensure 


write lockout plug is 
flush with surface of 
coisk cartridge» 
re"initiate LOD. 


DUPLICATE FILE File of snecified Remove Cwith RM) the 
NAME = filename name atready exists €xisting file from 
on destination disk. disk» then rerinitiate 
A disk may not contain LD. 

2 files with the same 

name- LD continues 

toading other filess 

ignoring any duptic- 

ates. 


CANNOT ALLOCATE No appropriately If specified file 
AREAS FOR = sized available is desired» replace 
fite-name. area on the dest- this disk with a 
ination disk for cisk having more 
specified file. available area. Then 
retinitiate LD. 


N/P ERROR = Nisk write error Place disk in opposite 
filename encountered white drive and rewinitiate 
system was toading LO. 
specified file. 


Insufficient avail- If specified file is 


AREA SIZES TQ0 
SMALL FOR = | able area on disk cestreds reoptace this 
filename. for specified Cisk with a disk haytng 
multitmarea file. more available area. 
Then retinitiate 


LD- 


NAME LIST FULL No space remaining Use another disk» or 
in disk directory remove unwanted files 
for another fite with the RM function. 


namee Function ends. 
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LS (List File Sizes) 


This function allows the operator to print name and sizes in sectors of each file on a specified disk. For dual 


pack files, both portions of the files and their sizes are printed. 


Format: 
LS disk-name 
Example: | 
LS ARDISK2 


Output messages: 


PACK disk=name NOT : 


ON LINE : 


Oxy DIRECTORY I70. 
ERROR 


8-<18 


POSSTIRLE CAUSES 


Specified disk is 
not on line to the 
computer. 


eS Successful (FE0J) 


A read or write error 
was encountered white 
the system was atte- 
mpting to access the 
directory of the 
Specified disk. 

The directory struc” 
ture of the disk may 
be corrupted. 


SUGGESTED ACTION 


Check input * reenter 


If necessary; 
Check for correct disk. 


OL (Print Status of Drives) 


This function allows the operator to print the status of all cassette and disk drives. 


Example: 
OL 
Output messages: 


MESSAGE POSSIBLE CAUSES 


1 


END OL OL successful (CEQJ)>» 


Specified disk is 
resident in specified 


disk drive disk- 
name 


drive. 


There is no disk in 
this drives the disk 
in the drive has not 
been set to runs the 
disk in the drive has 
not come up to proper 
speed*> system does 
not recognize disk. 


disk drive NOT 
READY 


disk drive NOT CMS = Disk in this drive 
STANDARD does not have a 
valid CMS tabet. 


There is no cassette 
in this drives cass- 
ette has not been 
loaded into drive 
properlys 
{ 
Cassette in specified 
drive does not have 4a 
valid label. 


cassette drive 
NOT READY 


cassette drive 
UNLABELLED 


cassette drive 
multiwfile"name 
file-name 


has the specified 
name. 


Cassette tin this drive 


SUGGESTED ACTION 


Nonee 


If apolicabte - set 
cisk to runs or atltow 


disk to attain proper 


Speed*> make certain 
disk has a proper 
"tabel”™. 


Nisk must be initiali zea 
with IN to create vatid 
CMS tabel. 


Check for proper 
loading of cassette 
In drive. 


Use FG to create 
valid cassette tabel. 


None. 


MTR cassettes do not have labels corresponding to the correct CMS format and thus will appear ““UNLA- 


BELLED”. 
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PO (Power Off) 


_ This function allows the operator to terminate the execution of the Stand-Alone Utilities. 
Example: 
PO 


The utility displays the message 7 
* * *END STAND ALONE UTILITY* * + 


and causes the B 80 to return to the initial state (PK1 and PK2 lit, see Figure 6-1). 
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RF (Reformat Disk) 


This function provides all the capabilities of IN (initialize), except the disk recording surface test. A CMS 
label and a CMS disk directory are written to the disk. Any information previously contained on the disk will 
be lost. The disk label will contain information supplied by the operator’s responses to the appropriate prompts, 
below, and the directory will be of the minimum size required for the number of files specified. The original 
contents of the disk label will be displayed to record the change and to assist re-input of the same data when 
required. The bootstrap is written back to track “0” in the same manner as for IN. 


Format: 
RF disk-name 


Example: 


RF ARDISK2 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


Prompt atltowing entry Enter cate (format 
of RF date. MM/DD/YY) 


Prompt attowing Enter number of files 
entry of Maximum cisk will contain 
number of files (less than 255). 

disk will contain. 


Prompt allowing Enter serial number 
entry of disk (6 numerals). 
serial number. 


Promot allowing Enter disk-name 
entry of disk Cuc to 7 characters). 
Nnanee 


Prompt attlowing Enter any yalia in- 
entry of uSer- formation Cup to 14 
defined information. characters). 


RESTRICTED 


Prompt» requiring 
a response of “N* 
at this time. 


Enter "“N*. 


BONTSTRAP VERSION RE 
nennenn USED End of Job CEOJ) None. 
END RFE | 
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Specified disk-name Check input Cre-input 
is not onwline to if necessary )5 7 
computer. Check for correct disk). 


PACK disk*name NOT 
ON LINE 


Dxy DIRECTORY A read or write Switch disk to alter- 
1/0 ERROR error was encou” Nate drive and re~ — 
ntered while system initiate RFF or 
WaS attempting to 
access directory 
of this disk. Oir- 
ectory of this 
disk may be corrupt- 
ed. 


SYSB 89 NOT PRESENT. System failed to Load another drive 
LOAD CMS BOOTSTRAP find a bootstrap | disk containing 
AND HIT OC#1 TO file from either | CMSBCOT>» or toad a 
CONTINUE. disk or cassettes cassette with name 

| : ~SYSB80 containing 
CMSBOOQT as its first 
file. Then 

press OCK1. System witt 
remattempt search for 
CMSBCOT. 7 : 
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RL (Relabel a disk) 


This function allows the operator to change a disk’s name without affecting the remaining contents of the 
disk. 7 
Format: 
RL disk-name 
Example: 
RL AP2 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


RL successful CECJ). 


Prompt to request Enter new disk name 
operator to enter Cup to 7 legal 
the new disk name. characters). 


PACK disk=name Specified disk is Check input - reenter 
NOT ON LINE not on Line to the if necessary; 
computer. Check for correct 
| cisk. 


Oxy DIRECTORY A read or write error 

I/O ERROR was encountered white 
the system was attem- 
pting to access the 
directory of the 
specified disk. The 
directory structure 
of the disk may te 
corruoted. 


Warning: 
If RL is used on a disk containing part of a dual pack file, that file will be inaccessible under MCP control. 


There are two ways to prevent this from occurring: 
Remove the file before relabelling the disk, or 
Copy the entire file to a single pack file before relabelling. 


There are two ways to resolve the problem if it does occur: 
Use Stand-Alone Utility (RM) to remove the file, or 
Use Stand-Alone Utility (RL) to relabel the disk to its original name. 
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RM (Remove Disk Files) | , @ 


This function allows the operator to remove files from disk. 


Format: 


: filename or 
RM disk-name/ group-name 
Examples: 


To remove a single file 
| RM PR1/PR200 


To remove a group of files: 
RM PR1/PR= 


To remove all files from disk: 
RM PR1/= 


Unlike the RM utility that runs under MCP control, the Stand-Alone RM will remove system software (MCP, 
COBOLINT, BILINTERP, etc.) without a warning message, the same as it removes other programs. 


Output messages: 


MESSAGE | POSSIRLE CAUSES — SUGGESTED ACTION 


filename RM success ful «: 
REMOVED 


PACK disk=name Specified disk is Check input 7 reenter 
NOT ON LINE not online to the if necessarys. 
computer. Check for correct disk. 


filename NOT | Specified file-name Check input ™ reenter 
FOUND is not on disk. if necessary» 
| Check for correct disk. 


RM successful CECJ); None if RM successful. 

Specified group name Check Input 7 reenter 

to be removed 1s not if necessary. 

on disk-e Check for correct disk. 


Dual Pack Files 


If a file to be removed has an overflow area or another disk volume: 


— if both parts of the file are available, both are removed and the following message is printed: 
filename REMOVED FROM disk-name-1 AND disk-name-2 


— if the overflow file is not found for any reason or if a file is found with the same file-id but which does 
not match the master file, then the following message is printed: & 


disk-name/file-name IS AN INCOMPLETE DUAL PACK FILE 


894. 


A MATCHING OVERFLOW FILE ON disk-name-2 
IS NOT PRESENT. PLEASE TAKE ONE OF THE 
FOLLOWING ACTIONS: 
A) SUPPLY THE CORRECT OVERFLOW PACK 
AND TYPE “A” TO TRY AGAIN 
B) TYPE “B” TO SKIP THIS FILE 
C) TYPE “C” TO REMOVE THE INCOMPLETE FILE 


If option “A” is selected then either the complete file will be removed or the above prompt will be repeated. 


If option “B” is selected then the following message is printed: 
filename NOT REMOVED, PART OF DUAL PACK FILE 


If option “C” is selected then the following message is printed. 
fileename REMOVED ONLY FROM disk-name-1 
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WS (Warm Start) 


This function causes a “branch” to the warmstart routine stored in the Read Only Memory (ROM) of the 
machine. It will cause the CMS operating system (MCP) to be loaded from disk into memory. 


Operating Procedure: | 
Type “WS”. then press OCK1. Wait for PKs 3,4,5, and 6 to be illuminated. 
Press PK3. 


Enter today’s date in the format: 
MM/DD/YY 
when prompted to do so. 


For further information, refer to the section headed “Loading the MCP’’. 
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LOADING THE MCP 


(This process is also called the “‘warmstart procedure’’). 


From the CMS Bootstrap Mode (PK3 to PK6 lit), depress PK3. 


The bootstrap will search for a disk file called “MCP”. The search for the MCP procedes as follows: 
bottom drive of highest-channel disk unit 
top drive of highest-channel disk unit 


bottom drive of lowest-channel disk unit 
top drive of lowest-channel disk unit , 
For failures in the search, see below, System Load Errors. 


If the MCP search is successful, the MCP is loaded to memory and MCP initialization takes place. The activity 
during this process can be distinguished on the D-lights. 


The initial part of the MCP is loaded (D2 light flickers). 
The console printer is initialized (if one exists). 


AVR (Automatic Volume Recognition, see below) is performed on all peripherals (D2 flickering with D4 and 
D7 on). 


For mini-disks, you will hear the disk start to click. The AVR procedure takes a few seconds to check 
the mini-disk. | | 


vw 


For cartridge disks, AVR procedures are very quick. 


Extended memory is loaded if applicable (D2, D3, D4, D5, D6, and D7 on). For this to occur, a file SYS- 
CONFIG must be present on the system disk and this must specify the use of extended memory (see B 80 sys- 
tem utility CONFIGURER). 


The system will print on the SPO (console or self-scan, according to data in the SYSCONFIG file) an MCP 
version message, followed by a list of on-line peripherals that are powered up. 


NOTE 
the version of the MCP is identified by mark/level/patch numbers. For example, ver- 
sion 3.00.17 is mark 3, level 3.00, patch 3.00.17. A new software release is denoted 
by a higher level number (for example, 3.01). Within a release, higher patch num- 
bers indicate improved versions of that level. For example, the application of two 
patches to 3.00.17 will create an MCP version 3.00.19 (see PATCHMAKER for de- 
tails of how to patch MCP files). 


The system will request the date. Depress the Ready Request button and verify that the ON, READY and 
ALPHA lights are lit. 


Enter the date as requested, followed by OCK1. (Leading zeros are optional). The system prints a date mes- 
sage. : 
The MCP automatically loads the program SYS-SUPERUTL (D2, D3, D4, D5, D6 and D7 on). 
If logging is specified in the SYSCONFIG file, the message 
“LOG TRANSFER INITIATED” 


is given, and the TL utility is loaded (D2, D3, D4, D5, D6 and D7 on) and executed (D2 flickering with 
D4 and D6 on). At end of TL execution, the message 


“TRANSFER COMPLETED” 
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is given, and SYS-SUPERUTL creates new log files (D2, D3, D4 and D5 on). 


Optionally, (depending on SYSCONFIG), a user program is loaded and executed (D2, D3, D4, DS, D6, and 
D7 on). | | | 


The warmstart 1s complete, and the MCP enters idle state (see below). 


It is advisable not to enter system commands until the complete warmstart procedure is over, otherwise con- 
fusion can result. Also, such input is not entered in the system log. - 


Example: 


+ 
ry 


DCMOP VERSTON O8, 
FEBS O FTLES 


"A FAS SYS DISK 


ENTER DATE &S MM/DDS TY 
rae ae 
Fr Te er ee oe 


~ WW RS Sree eee eT 
i re tO | ea Pyle Pik 


TRANSFER COMPLETED | 
COMMENCING LOG FILE REALLOCATION 
( 


LOGGING TS TN TTTATED G0 OF Yad ee 


For possible errors, see System Load Errors, later. 
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BASIC OPERATION UNDER MCP CONTROL 
D-lights 


During MCP execution D lights D1 to D8 give an indication of system activity, as follows: 


mix number of 
currently executing 
task, value 0 to 15 

(D4 =8, D5=4, 

D6 =2,D7= 1), 

see Mix Number 


If on, or flickering, some input or output activity to disk, cassette, 
printer or other peripheral is being performed. 


If the lights D4 to D7 are all off, this indicates system activity not related to a particular program. For exam- 
ple, AVR procedures result in D2 only being lit. 


If the lights D4 to D7 are all on (value 15), this indicates processing of an input request or loading of a 
program. 


MCP states 


After warmstart is complete, the MCP is either idle or executing a task. The idle state is identifiable by the 
absence of activity on the D-lights. In this state, three distinct patterns can be encountered: 


D2, D3 only lit: The last activity was a 


program gone to EOJ. 
D1, D3, D4, DS only lit: The last activity was a 


SYS-SUPERUTL function GIR, 
| LB, LF, PD, RM, KX or CH). 
D1, D3, D4, D5, D6, D7 only lit: The last activity was a 


system intrinsic. 
When the MCP is executing a task, the mix number is evident in D-lights D4 to D7 (see Mix Numbers). 


At any time when the system is idle, it is valid to terminate the MCP by a PO of the system disk (see PO 
intrinsic). 


Mix Numbers 


The following table indicates the mix numbers for B 80 activities: 
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mi x-number task | | | DP &-p7 Lights | 


0. * system activity | none 

1-8 | user proorams _ various | 

a * AVR. pee | D4» 07 

1011 _ utility programs various 2 

12 6 SYS*SUPERUTL Phe 0S : 

13 MCS Das D5» D7 

14 * NDL a | D4» O05» 06 

15 * program toader/input | 3 
requests 7 7 — Das D5» DE» D7 


* these tasks are not shown in the response to the MX intrinsic. 


+ SYS“SUPERUTL iS not Shown in the response to the MX intrinsic 
unless a particular function is being performed? in this case» 
the 4X responSe Shows the name of the function» for example» — 

127RM » or 12/P) 


Normal user programs or compilers are allocated the next available mix numbers in the range of 1-8. Utilities 
are allocated the lowest available mix number from 10 or 11. ar | te ga 


Automatic Volume Recognition (AVR) 


This procedure is carried out if any new media is loaded onto the system. If the procedure fails, the device 
is made not ready. The procedure varies for different media. , | 


For disk cartridge, Burroughs Super Mini (BSM) disk, and ICMD, AVR will attempt to read the label. 
For cassette, AVR will search for a CMS label or scratch label, otherwise the cassette is treated as unlabelled. 


In all cases, if transient errors are suspected, Ready the peripheral (see RY intrinsics) to re-initiate the AVR 
process. 


Console Keyboard Under MCP Control 


Under MCP control, the console keyboard may be used to enter system commands to the MCP, or solicited 
data to a program. Commands to the MCP may only be entered when the READY light is lit. Data to a pro- 
gram may only be entered on the alpha keyboard if the ALPHA light, but not the READY light, is lit. Input 
is terminated by an OCK key, or a PK key only if the corresponding PK light is lit. It can be seen that the 
keyboard can exist in one of three states; inactive, system enabled, or program enabled. | 


Since an understanding of the operation and behaviour of the keyboard and its indicators is essential, some 
important points are noted here. | 


If a disabled key is pressed at any time, or too much data is entered at once then an error bell will ring 
and the ERROR indicator will light, this error condition must be reset before any further keyboard input can 
be made. 


The RESET key has two basic functions, resetting the error condition explained above, or clearing the infor- 
mation keyed since an OCK or PK key was last pressed. This key is necessarily enabled whenever any alpha 
or numeric key is enabled. : 


When some incomplete information has been keyed either to the MCP or a program then it is necessary to 
terminate some information to this destination before entry to the other destination can be allowed. For exam- 
ple, once the ready light is lit an OCK key must be pressed to terminate input to the MCP before any input 
can be keyed to a waiting program. This restriction stands even if the reset key is used. 


8-30 


If the keyboard is enabled for input then the D-lights are not lit. 


In order to enable keyboard input to the MCP the ready enable key must be pressed. This key will be ignored 
if the SCL/LOADER routine of the MCP is currently executing a system command or loading a program (D4, 
DS, D6, D7 lit) and a wait of up to 30 seconds may be necessary before any keyboard input can be made. 
similarly if the MCP is very busy when a request for input is made there may be a delay of one or two seconds 
before the keyboard will become enabled for input. A maximum of two characters can be entered in this time, 
or a keyboard error condition will arise. 


If the system is being used with the self-scan screen operating as a SPO device as well as a console file, then 
the ready enable key has an additional function. This key must be depressed in order to prompt the MCP to 
display either the complete screen-ful of messages on the screen, or the last message on the bottom line of the 
screen (scrolling the other information up one line). When the screen is being used as a console file, the screen 
will display information from the program using it until the ready enable key is depressed. 


If the screen is displaying SPO information, depression of an OCK will return the display to the console file 
information. 


Interrupting The MCP 


It is possible to interrupt the MCP while it is running, this will inform the MCP that some action must be 
taken. The ability to interrupt the MCP is a good indication that the system is running satisfactorily. The only 
conditions where it may prove impossible to cause an interrupt is when the MCP is processing a system com- 
mand or loading a program. Typical interrupts and the consequent processing include: 


Press READY ENABLE button. This will cause the MCP to enable the keyboard for input. 


Opening or closing the serial printer cover will cause the MCP to prevent or allow output to the printer ac- 
cordingly. 


Loading a disk or cassette will cause the MCP to read the label and perform the AVR procedure. 
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MEMORY DUMP TO CASSETTE 


The system must be in the CMS Bootstrap state. If the system had clear-started, depress PK2 to get to the 
CMS Bootstrap state (PK3 to PK6 lit). | 


Depress PK4. The numeric light will be lit. 

Insert a write-enabled cassette in any cassette drive unit, and wait until fully rewound. 

Depress the numeric key (1 to 4) corresponding to the drive unit containing the cassette. (CTA=1 etc.) 

The contents of RAM will be written to the cassette. During the dump, an indication of the memory address 
being dumped is displayed on the PK lights. At the end of the dump, PK17 to PK24 lights are lit. The cassette 
will be labelled ““MEMDUMP/MEMORY”’. The system will return to the bootstrap state (PK3 to PK6 lit). 


Remove the cassette, clearly mark it with the date and time, and submit it with details of the fault to your 
support personnel. 


For possible errors, see System Load Errors, below. 


MEMORY DUMP TO DISK 


The system must be in the CMS Bootstrap state. If the system had clear-started, depress PK2 to get to the 
CMS Bootstrap state (PK3 to PK6 lit). 


Depress PK5. The system will search the disk (from which the bootstrap was loaded) for a file called MEM- 
DUMP. 


The utility GEN.DUMPFL may be used to create a suitable file on the system disk. This must have been 
done before a dump to disk is attempted. It is recommended that for minidisk-based systems a spare 
minidisk is kept with a MEMDUMP file on, and this disk is the only disk loaded when the memory dump 
to disk is taken. This will avoid any possible confusion between MEMDUMP files on different disks. 


The contents of RAM will be written to the MEMDUMP file. At the end of the dump, the CMS Bootstrap 
state will be entered (PK3 to PK6 lit). 


For possible errors, see System Load Errors, below. 


NOTE 


Valid memory dumps will be produced only if the pertinent error condition was the last event 
on the system. Invalid memory dumps will occur if the machine main cabinet has just been 
switched on, or the error condition did not occur under MCP control, or PK1 was depressed 
while in initial state (PK1 and 2 lit). 
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SYSTEM LOAD ERRORS a ad @ 


The following table of errors cover all symptoms found during start-up of the B 80, warmstart, memory dump 
to disk or cassette, or entry to Stand-alone utilities. 


SYMPTOM | | POSSIBLE CAUSES SUGGESTED ACTION 


Sequentiat tighting MTR switch in Set MTR switch to 
and extinguishing of wrong position. "normal". Nepress 
Lights does not occur _ tcad Enable button. 


on entry to Initial 
State (for examples. 
deoressing Load Enabte 
button). 


From Initiat States Keyboard Locked in Depress shift key. 
PK2 is tqnored. "“shift™ mode. Depress Pi 2. 


Depression of PK2 PK1 was depressed Depress Load Enabte. 
Causes numeric by mistake (this Depress PK2. 
Light to be lite clears Memory). : 


Depression of PK2 
causes keyboard 
Lights nlus ERROR | 7 & 
|light» to be lit: | 
(a) Di through 08 No bootstrap found Check on disk used. 
Lit  Cdisk not initial- Reloed with correct . 
| iZed correctty). disk. Press Load 
Cb) one 0 Light Disk media or drive Enable. Press PK2. 
not lit» plus faulte See -elow for diagnosis. 
PK Lights lit | Note D and PK lights. 
Check that disk is 
not at fautt by using 
disk in another drive. 
Power cff faulty disk » 
replace with backup 
copy. Request tech 
nical assistance. 


Att keyboard : Memory parity Depress Load Enable and 

indicators flash retry- Request technical 
assistance if not 
successful. 


Warmstart stops 
with O02 Lit. 


Print head does 
not initialize at 
start of warmstart. 


Memory jump to 
cassette: System 
warmstarts 


Memory dump to 
cassette: keyboard 
ERROR Light is Lit 
when nUmeric key 
depressed. 


Memory dump to 
cassette: ERROR 
light is lit 
after 10 Seconds. 


Memory dump to 
cassette: ERROR 
light ts lit 
during dump. 


Memory dump to 
disk: Depression 
of PKS causes one 
0 Light olus 
ERROR» to be tit. 


Memory dump to 
disk: ERROR 
Light is tit 
during dumo 


Memory dump to 


disk: system warm- 
starts 
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Console printer 
not ready. 


Consote printer 
faulty. 


PK3 was depressed 
inStead of PK&4., 


Wrong Cassette 
drive has heen 
selected» cassette 
Is not write- 
enabled» or tape is 
rewinding. 


Cassette is insert: 
ed backwards. 


Irrecoverable tape 
error, or accidental 
opening of cassette 
drive unit. 


No MEMDUMP file 
on diske 


MEMDUMP file on disk 
1S too smatl to hold 


memory contents for 
this machine. 


PKZ was depressed 
instead of PK5. 


Check forms transport 
cloed- Check printer 
cover down. Check 
levers tn correct pos 
ition. [If system does 
not continue» depress 
Ready then OCK1. 


Open and close cover. 
Repeat warmstart. 
Request technical 
assistance. 


Memory dump cannot 
now be taken. At tow 
warmstart to complete. 


Correct fault in 
cassette. Depress 
Reset. Enter correct 
numeric key. 


Correctly insert 
cassette. Penress Reset. 
Enter correct numeric 
key. 


Allow Cassette to 
rewind» or replace 
cassette. Depress 
Reset. Enter numeric 
key. 


Load a disk with a 
MEMDUMF file ana 
cepress Pk2 then PKS . 
to retry the dump. 


Load disk with targer 
MEMNUMP files depress 
PK2 then PKS to retry 
the cump. 


Memory dump cannot 


now be taken. Attlow 
warmstart to conplete. 
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Entry to S.A.U: SAU Could not be | Note D and PK lights. 
Nepression of PK6 loaded from disk: Remove disk» replace 
causes one 9) tight» disk error. with backup copy. 
plus ERROR» to be Og Press Load Enabte» PK2 
Lit. | and FK5S. See below for 

| diagnosis. 


Entry to S.A.U: Consote printer Check forms transport 

lload stops with att not ready. closed. Check printer 

keyboard tights tit. | cover downe Check Levers 
in correct position. | 
Urility should continue. 


Diagnosis of Disk Errors at System Load Time 
The disk load routines may fail for two distinct reasons, both indicated by the D lights. 


If all D lights D1 to D8 are lit, then the required information (bootstrap, SAU, MEMDUMP) was not on 
disk. : 


If not all D lights are lit, then information found on disk was not reliable due to disk or disk drive errors. 


If all D lights D1 to D8 are lit except one, then the failure occurred during bootstrap load and the exting- 
uished D-light indicates the disk unit at fault. | 


If only one D light is lit, then the failure occurred during other disk activity (MCP load, SAU load, memory 
dump to disk), and the illuminated D light indicates the faulty disk unit. 


In addition, the PK lights indicate the nature of the fault. 


Make a note of each D light and PK light setting and take action as in the tables above. The meanings are 
as follows: | 


Di channet 0O 
D? channel 1 


58 channel 7 


PK1 off = top drives on = bottom drive 
PK2 off = seek complete 

PK3 off = end of cytinder 

PK4 off = search complete 

PKS off = more details in PK9 to PX*15 
PXK6 on = operational | 

PK7 off = Seek incomplete 

PK8 on = good status 

PK9 on = equat 

PK10 on = on cylinder 


PK11 off = illegal seek 
PK12 on = write inhibit 
PK13 off = sector not found 


PKi4 off LRC error (parity) 
PK15 off = tltegal command sequence. 
PK16 off = device error 
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CPK9 to PK16 are significant onty if PKS is off). 


PK17 = PK24 indicate number of attempted retries before 
7 error is declared. 
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ERRORS UNDER mcP CONTROL 


The following table of errors covers many symptoms found while using the B 80 under normal control of. 


the MCP, with suggested causes and actions to take. | 


SYMPTOM 


Unidentifiabtle 
problem 


tittle happening» 
with D2 one D3 off 


most of time 


PK Lights 17 to 24 


flashing with "DF" 
pattern Consonso ff» 
OnesOons0ner On 20n) 
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POSSIBLE CAUSES 


MCP file corrupted 


System thrashing; 
too many jobs or 

too targe jobs in 
mix. 


Extended memory 
not correctly 


hardware disk IC 


error during 
MCP task 


SUGGESTED ACTION 


Use backup copy of 
MCP 


If console not in 
uSe» set CT! ON. 
I€ Light pattern 
above PK17 to PK20 is ° 
on» one off» ons then 
thrashing is confirmed : 
D lLichkts 4 to 7 indi- 
cate mix nunber of 
executing task. Try ent= 
erinc MX to clear 
condition : if not 
sucessful» take memor y 
dump and do clear start 
> recuest technical 
assistance. 


Run CONFIGURER and 
warmstart 1f necess= 
arye 


Take memory dump: 
request technical 
assistance to analyze 
memory dump to find 
disk address for use 

in fixing the disk. 

To help find the fault» 
warmstart and run the 
KA utility on the 
system disk before 
executing any programs. 
(See KA» section 4). If 
Shows any "AREAS 
ASSIGNED TWICE™ the 
disk directory may be 
bade DG NOT USF THIS 
DISK until recovery 
operations have been 
completed. 


PK tights 17 to 24. 
flashing with "AC" 
pattern Consoftfso0n» 
offsonsonso ff roof f) 
or “AD™ pattern (Con 
of fronsof f20n 20N » 
of fx on) 


non-zero retry 
count on PO of 
system disk 


Logging not taking 
place 


PD» RM function 
not available 
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see below: 


hardware disk I70 
error during MCP 
disk directory 
operation. 


logical error tn 
disk directory 
due to previous 
fautt. 


Deteriorating disk 
performance. 


Improper care of 
removable disks: 
possibly faiture to 
retinitialize disks 
after long use 


SYS@SUPERUTL not 
on systems disk. 


TL not on systems 
disk 


Logging not specc 
ified in SYSCONFIG 
file. 


No SYS*SUPERUTL 


SYS“SUPERUTL atready 


performing one of 
its functions (see 
discussion in 
Section 4). 


(Take recovery action 
as for “DF” messages 
above: NO NOT USE THE 
DJSK until recovery 

éction is completed.) 


Request technical 
assistance to fix 
the disk. 


Rerun using backup 

cisk : analyZe corre 
uptec disk using S.A.U. 
PDX function and report. 


Ignore if 10 or 20 
during normal 

running in one daye 
Calt field engineer 

if greater rate 

than usual rate for the 
Site. 


All frequently used 
removable disks should 
be cleaned and 
re“initiatized 
regularly (for example» 
on a monthly basis). 


Load SYS*SUPERUTL 
to systems disk. 


toad Tt to systems 
disk 


Rerur CONF I3ZURER 
and warmstart.e 


Load SYS*SUPERUTL 


to systems disk. 


Check with MX if SYS= 
SUPERUTL is performing 
a-function Cmix*numrter 
12 gives the name of 
the function): wait 
then reenter command. 


Cannot run data. 
comm 


Degraded oer formance 


System not active: 
programs in mix 


but D-tlight pattern 
does not change> 
keyboard 
|} example, 

| possible. 


Input Cfor 
MX) 15 


No NDLSYS file on 
System disk 


NDLSYS file does not. 
correspond to actual 
network on machine. 


NOL-~INTERP not pres™ 
ent on system disk. 


(ens RO teenth PVE Purses Umea 


No MCS oroaram 


Lack of memory due 
to incorrect use 

of Extended memory, 
wrong SYSCONFIG 

file on system disk. 


| 


Lack of memory due 
to memory fautt at 
warmstart time. 


Program Swappded 
out waiting on 
memory. 


persists» 


Load NOLSYS file 


Cyou may need to 
run an NDL compil- 
ation. 


load correct NDLSYS 
files or recompile 


ONDL program. 


Make sure the correct 
Interpreter (Cfor example 
MICRCPCL) is named 
NOL-INTERP and located 
on the system disk. 


Fnsure that the correct 
MCS is executing as well 
as any user data comm 
progratte 


Run CONFIGURER, 


repeat after warm- 


Catt field angineer. 


Enter <mix> GO to 
resume program ex” 
ecution*s if symptom 
program 1s 
too large for avait> 
able memory. 


System not active : Consote file input Complete inout using 


programs in mix but in process. an OCK key. 

D-tight pattern does (—————_________9. 

not changes keyboard System printer is Open ard close orinter 
input (for example» jammed. cover to initialize 
MX) causes error | print head. Repeat if 
pelt to ring not successful first 


time. If stilt not 
successful» perform 
awarmstarte 


| : | 


Peripherat Cpossibly '} Enter CL command. If not 
Line printer) hang successful» make per- 
1pheral ready or not 
ready> switch if off or 
cns insert and untoad 
spare cassette in cass” 
ette drive. If this 
fails» take memory dump» 
report fault» and warm 
starte 
Note: never toad or 
unload disk media» or 
Cassette media which 
are In uses until 
system has returned to 
to initial state. 


MCP software error Take memory dump» report 
fault» and warmstarte 


System initializes Corrupted MCP Take memory dump» 
(PK1 and PK2 Lit) code file. report error» rerun 
cn backup disk. 


Unexpected hardwara Take memory dump » 
errofre report error» re* 
warmstarte 


Unknown MCP error. Take memory dumo » 
report errors» attemot 
to rerune If stitt not 
Successful» request 
technical assistance. 


PK Lights 17 to 24 MCP thas detected Refer to section 


flashing (pattern an error condit- on MCP diaaqnostic 

other than above) ion from which it messages for further 
Cannot recover. details. 

Att keyboard Memory parity Initialize system» and 

lights flash rerun. If stitl faulty» 


call field engineer. 
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Program load taking 
long time = keyboard. 
disabled and ). 
tights 4 to 7. 
flashing. 


HISSINg Sound from 
disk drive. 


Non“functional. 
disk drive, 


I/O errors from 
disk- 
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Program Loaded 
thrashing due to 


lack of available. 


Memory; too many 
or too large pro 
grams in mix. 


Disk drive heads 
are camagede 


Hardware fault on 
drive, 


Non=function disk 
drive. 


Crashed disk head. 


Physicat damaged 
disk media. 


Disk media has 
bad areas. 


Try keyboard input. I f 
this fails» initialize 
system and retry. — 


Stop work. Remove the 
disk from the damaged 
drive. THIS DISK IS 

PROBABLY DAMAGED» DO 
NOT LOAD ANY OTHER 

DISK INTO THE ORIVE. 
Cail field engineer. 


Load a good disk on. 
crive (EXCEPT IF DRIVE 
hFEADS KRAVE CRASHED)» run 
LS utility. If this 
produces errorss the 
Crive is faulty: catt 
fielcac engineer. 


See above. 


See above. 


Replece with new 
disk media. 


Run CHECK.DISK to report 
on parity errors. Run 

KA to give disk direct- 
ory analysis: If this 
shows AREA MISSING or 
AREA ASSIGNED TWICE» 
send the KA plus recent 
SPQ message log to 

field engineer. Run OA 
to give further analysis 
of disk. 


Use tackue disk for 
system files. Re- 
cover any other files 
Dy attempting to 

CNPY them one-by~one 
from the corrupt disk 
to a good disk. 


B 80 DEPENDENT UTILITIES 


The following pages describe those system utilities which run under MCP control but which are relevent only 
to the B 80 CMS software. 
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CONFIGURER (Configure B 80 Software System) 


This utility sets up data in a disk file called “SYSCONFIG” to determine how the B 80 is to be used. Th 
SYSCONFIG file must be present on the system disk if any of the software options are to be used, other than 
the defaults given later. The data in this file is examined at warmstart time. Therefore any options specified 
will only be effective after the next warmstart. | 


To execute, enter 
CONFIGURER 


The utility runs in an interactive mode using the console as input. 


“SPO LOGGING REQUIRED Y OR N”’.. Enter “Y” if a log of SPO messages is to be kept on disk. This 
will normally be required if the SPO messages are sent to the self-scan display where there is no hard-copy. 
If no SPO logging is required, enter ‘“‘N”’. 


“ENTER NUMBER OF LOG FILES”. Enter a number between 3 and 16. At warmstart this number of 
files will be created on the system disk to hold the logs. The names of the files are “SYS-LOG-01” to “SYS- 
LOG-nn” where “n” is the number entered. The minimum is 3 files. 


“ENTER LOG FILE SIZE IN SECTORS”. Enter a number, which will be the size of each of the log files, between 32 and 
16383. The minimum log file size is 32 sectors. Therefore the minimum disk space for log files is (32 x 3) sectors. 


“INFORMATION FOR WARM START: ENTER ID OF FILE TO BE ZIPPED”. If it is desired to execute 
a program at the beginning of each warm-start, enter the name of the program code file (including disk-id if 
not on the system disk) to be executed. If no program is to be run, make a null input (just OCK1). 


“ENTER STARTUP MESSAGE”. Enter up to 80 characters, terminated by OCK1, as a warmstart message. 
This message will be displayed at the beginning of each warmstart. If no message is required, just depress 
OCK1. | 3 | 


“ENTER POWER OFF MESSAGE”. Enter up to 80 characters, terminated by OCK1, as a message to be 
displayed when the system disk is powered off. If no message is required, just depress OCK1. 


“SPO OPTION SSA OR SPA”. Enter “SSA” if it is desired to display SPO messages on the self-scan display. 
This will free the console printer to be used entirely by programs with console files. The self-scan can also be 
used by programs. When the self-scan is used both programmatically and as a SPO, the SPO messages are dis- 
played when the ready enable key and OCK1 are depressed. | 


Enter “SPA” if it desired to write SPO messages to the serial printer. This is especially useful if the console 
printer is equipped with more than one tractor, in which. case only the bottom left-hand tractor will be used 
by the MCP for SPO messages, and other tractors can be used exclusively by programs with console files. 


“CHOICE OF EXTENDED MEMORY ITEMS 
BILINTERP A COBOLINT B 

NDLINTERP C INDEX COMMS D 

ENTER PREFERRED ORDER”. 


Enter the letters “A”. “B”. “C”. or “D” to determine which items are to be placed in extended memory 
(above 64K bytes). The order of letters determines the order in which these items are placed in extended 
memory. If there is no extended memory left, the items will remain in the part of memory below 64K. For 
example, if the order was ABD then the MCP would first attempt to place BILINTERP in extended memory. 
If this was not possible, BILINTERP would remain below 64K. If successful, the MCP would then attempt to 
place COBOLINT in extended memory, followed by an attempt to place INDEX COMMS in extended memory. 
If all items are successful, and data comm is present, the MCP will attempt to place the data comm buffers 
in extended memory if there is space available. If at any stage there is not enough space in extended memory, 
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the complete item is placed below 64K, that is, no item is split between non-extended and extended memory 
_ (even if written as more than one segment of ‘code). Refer to release notes for exact memory sizes. 


“JOB COMPLETED”. This is displayed when the utility terminates. 


Defaults: 
If the SYSCONFIG file is not present on the system disk, the following options are assumed: 
SPO logging is enabled. 
The number of log files is 3. 
The size of each log file is 32 sectors. 
No message is displayed at startup. 
The SPO option is SPA. 


No items are placed in extended memory, not even data comm buffers. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
ILLEGAL NUMRER A number outside Wait for repeat» then 
OF LOG FILES the range 3-16 enter correct vatue. 
| WaS entered.  _ - 
ILLEGAL FILE A number outside hait for repeat» 
SIZE the range 32716383 promote» then enter 
7 WaS entered. correct vatue. 
ILLEGAL . A file-name enter- Wait for repeat 
ed does not have prompts» then enter 
the correct format. correct value. 
INVALID CHARACTER IN Typing mistake Check input and reventer 
IDENTIFIER identifier when prompted. 


** INVALID SELECTION -' Option has been spec™ Wait for repeat prompt»> 
RETRY** ified which is not then enter correct 
one of atlowed values. information. 


PARITY ERROR ON Parity error occur- Investigate cause 
WRITE TO FILE red while writing of disk error. Use 
file-name. ERROR information to different disk. 

AT RECORD NUMBER the SYSCONFIG file. Repeat execution of 


number. Utility terminates. program. 
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DUMPANALYSE (Analyze B 80 Program Dump Files) 


When a program is DP’ed (see DP intrinsic) a file on the system disk is created with a name DMFILnn where 
nn is the mix number of the program dumped. This utility provides an analysis of this file, for use by technical 
analysts, printed on the line printer. | 


If the dumped program was written in MPL (used BILINTERP) only the dump-file is required for a full anal- 
ysis. If the dumped program was written in COBOL or RPG (used COBOLINT), a fuller analysis can be pro- 
vided by specifying the program code file as well. | 


Format: 


DUMPANALYZE | disk-name / dump-file-name 


| disk-name / program-name 


Note that the program name must be the name specified at compile time and placed in the code file. This 
is normally the same as the disk file name but the file name could have been changed by the CH utility. If 
the wrong program name (or none at all) is given for a COBOL or RPG program, then the dump analysis — 
will be incomplete (no COP table data can be analyzed). 


Examples: 


To analyze the dump file of an MPL program DP’ed when it was mix number 1: 
DUMPANALYSE DMFIL01 


To analyze a dump file (which had been copied to a new file DPFILE on disk PRB) caused by DP’ing the 
COBOL program AR678: | 


DUMPANALYSE PRB/DPFILE AR678° 


To analyze the dump file created by DP-ing the RPG program RS202P. The program was at mix number 
3 and the code file resides on disk RTB: | 


DUMPANALYSE DMFILO03 RTB/RS202P 


On completion of the printed analysis, the dump file is removed from disk. To preserve a copy of the dump 
file, make a backup copy (using the COPY program) before executing the DUMPANALYSE program. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


**WARNING** BIL Program name has 

DUMP FL» SECOND | been specified for 

PARAMETER IN adumo fite from an 
| INIT.MESS IGNORED MPL program. 
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PACK ID TOO 
LONG disk-name 


FILE ID) T00 
LONG file-name 


INVALID CHARACTERS 
IN FILE filename 


file-name NOT 
FOUND 


INTERPRETER VERSION 
NOT SUPPORTED 
interpreter=-name 
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Disk*name exceeds 


7 characters. Util- 


ity terminates. 


Filename exceeds 
12 charactes. 
Utility terminates. 


File-name or program 
name misspelled. 
Utility terminates. 


Dump file or program 
file cannot be found. 
Utility terminates. 


NOumo file is corre 
uoted;s Error in coa™ 
piler creating prog- 
ram filee | 


Check input and 
reventer. 


Check tnput and 
re-enter. 


Check tnput and 
rew"enter e 


Check input and 
rementer. Or make 
file present by 
doading program 
or dump file from 
backup copy. 


Use tackup copy of 


dump files retain 
program code fite 
and request tech>- 
nical assistance. 
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GEN.DUMPFL (Create Empty B80 Memory Dump File) 


Before the contents of memory can be dumped to disk, an empty disk file called MEMDUMP must be cre- 
ated. This file must be large enough to take the contents of all the memory of the system on which the dump 
is being taken. 


The size of the file is specified by “number”. in the range 64 to 11264. If “number” is not given, the size 
is for a 64K machine (the default value of “number” is 64). | 


Format: 


GEN.DUMPFL | number | ON disk-name | | AS file-name 


Examples: 


To create an empty file called MEMDUMP on the system disk for a B 80 with 80K bytes of memory: 
GEN.DUMPFL 80 


To create an empty file called MEMORY.DUMP on disk PRB for a 128K B80: 
GEN.DUMPFL 128 ON PRB AS MEMORY.DUMP — 


Note that this file-name must be change to “MEMDUMP” before a successful memory dump can be taken. 
Any existing file of the same name will be removed when the new file is created by this utility. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


SPACE RESERVED Successful F£OJ None. 


SIZE TON SMALL | "number™ is tess Reinpute 
than 64. 


SIZE TOO LARGE "number" is greater Re-input.« 
than 11264. 


DISK NAME TOO name is greater Reinput.e 
LARGE © 7 characters. | 


FILE NAME TON name is greater Re~input. 
LONG le characters. 


GT (General Trace) 


The general trace command is an MCP intrinsic which displays various diagnostic information either on the 
system console or on the line printer. The general format is: | 


Format: 


ON 
OFF 
GT printer-peripheral 
diagnostic-class switch-value 
disk-peripheral | 


To turn the trace printing on, with printing on the console (SPA) enter 
GT ON 


To direct the diagnostic printing to a line printer, specify the printer peripheral. For example 
GT LPA | 


Note that the trace must also be turned ON in this case. The trace will be interleaved with any program 
printout. 


To turn the trace off, enter 
GT OFF 


To display the cumulative number of retries performed on a disk unit since the last warmstart, specify the 
desired peripheral. For example, 


GT DMA 
The general B80 machine code trace is implemented as follows: 


Each trace point is identified by a diagnostic class and a diagnostic value. The class is one of 16, identified 
by a hex digit (0-F). This identifies the system function being performed, as follows: 


0 Open/close file handling routines 

1 Indexed file handting 

2 Accept/display routines 

3-7 Intrinsic functions Cfor exampte» SORTINTRINS) 
8-9 Automatic volume recognition CAV) routines 

A Nisk space allocate/deattlocate routines 

B Interpreters (BILINTERP» COBOLINTs NDL.INTERP) 
C MCP commUnicate handter (MCH) 

D Virtual memory (VM) routines 

£ Task control routines (for example» BAILIFF) 

F 1/0 master interrupt handter (“IP) 
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The diagnostic value is a hex number (0-F) giving a measure of depth of trace required (0 is least significant, 
F is critical). 


The GT command allows the storage of a switch-value for each diag-nostic class. If the trace has been initiated 
via the GT ON command, then each time a trace point is encountered in the machine code, a diagnostic printout 
will occur if the switch-value for that class of trace is lower than or equal to the diagnostic value of that trace 
point. For example, if a particular trace point had a diagnostic value of C, then a trace point would occur if 
the switch value for the appropriate class was in the range 0-C inclusive. If the switch value set by the GT 


command was D, E or F, no trace print would occur. 
The default values set at warmstart are: 
trace option OFF 
diagnostic print directed to SPA 
all switch-values set to F. 


Therefore the only trace prints that will normally occur are the critical ones (diagnostic value F). 


Note that if the trace option is ON the PK lights display the current trace point, whether or not the printing 
takes place, as follows: 


diagnostic-class diagnostic value 
in binary in binary 
(0000 — 1111) (0000 — 1111) | 


For example, a trace point with class D (binary 1101) and severity 7 (binary 0111) will cause PK lights 17, 
18, 20, 22, 23 and 24 to be lit. : 


The switch-value entered in the GT command must contain two hex digits: 
first digit — switch-value for register diagnostics | 
second digit — switch-value for memory diagnostics 


If no options are specified for the GT command; then the current switch values for each of the 16 diagnostic 
Classes is displayed. : 


Examples: 


To find the retry count for DMA and DKA 


GT OMA | | | 
DMA 0 RETRIES 
GT DKA 


ST DKA NOT ON SYSTEM 
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To set the switch-values to CC for interpreters, then interrogate all switch values, then turn on printing to 
LPA: 


GT B cc 
GT 
DIAG SWITCHES FF FF FF FF FF FF FF FF FF 
oooeeFF FF CC FF FF FF FF 
GT LPA 
GT ON 


Note that only the disk-peripheral option and the GT command with no further options result in an immediate 
response to the operator. 


Format of diagnostic printout: 


The format of a register diagnostic message is given here, where each X represents a single hexadecimal digit. 
The hex string is printed on one 8line. 


register: AD BO B1IFL J K L 


XX XX XXXX XXXX XXXX XXXX 
register : M1 M2 WR x Y AD,ESCT 
XXXX XXXX  —-XXXX XXXXXXXX XXXXXXXX XXXX 


The diagnostic class and value are given by the AD register (first 2 digits, repeated in first pair of last four 
digits). For example, a DF dignostic with M1 = 1111 would look like: 


DF MM KKRKXK KMKKK KKMKX KMXKKX KKK 
L211 MMKXK MMKXK KRRRXXKKKK KUOKKKKKX OF x x 


where x indicates any hexadecimal digit. 


When GT is switched on, system fatal errors (which would normally result in a set of PK lights 17 to 24 flashing) are 
reported as a diagnostic printed message followed by initialization to the Initial state. A memory dump should normally be 
taken to find more information. When GT is switched off, the pattern of PK lights 17 to 24 that are set flashing on a system 
fatal error correspond to the value of the AD register. 
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PATCHMAKER (Patch B 80 Machine-Code Object Program Files) 


This utility reads a file of patches from disk or cassette or from console keyboard input and patches a ma- 
chine-coded system software item. Stringent conditions are enforced to make the patch, including the necessity 
to apply each patch in the correct order. All previous patches must be applied before making the next patch. 


Note: it is essential that an unused copy of all micro-coded software items is retained for patching. It is not 
possible to patch a B 80 MCP that has been used in normal B 80 operation. This is because certain MCP tables 
included in the code file are modified during operation. This modification would cause the check digit calcula- 
tions in PATCHMAKER to fail. The Stand-Alone Utility (S.A.U.) COPY function may be used to create 
unused copies of all system software for patching purposes, and also to create backup copies of patched soft- 
ware. Files on the system disk cannot be patched: they must reside on a user disk. 


To execute, enter 
PATCHMAKER 


The utility runs in an interactive mode. 
The utility displays on the SPO: “IS PATCH FILE TO BE ENTERED FROM CONSOLE” 
and waits on an ACCEPT. 


If the operator enters | 
AX mix-number YES 


then the console file will be opened. Any other response causes the utility to ask, via displays on the SPO, 
if the file containing patches is on a cassette: if the response is “YES” a tape file named “PATCHES” is re- 
quired, and any other response requires a disk file on the system. disk named “PATCHES”. 


If a console file is opened the utility displays 
“2 DATA PATCHES 
SIGNIFY WHETHER PATCH FILE IS TO BE 
OUTPUT ON CASSETTE OR DISK °” 


The operator may enter, via an ACCEPT, either “CASSETTE” or “DISK”. Patches entered subsequently 
on the keyboard will be written to the specified medium. = 


The utility displays 
“ENTER PATCHES NOW” 
The patches must be entered via the keyboard from the hard-copy provided. The characters and terminating 
keys must be entered exactly as supplied, although spaces are not significant and may be entered as found con- 
venient. The utility will ask for resubmission of lines which are obviously incorrect. 


If correct, the message : 
“PATCHES HAVE BEEN ENTERED CORRECTLY 
“2END PATCHES” 


is given. 


When the correct patch has been entered, the utility displays on the SPO 
“IS PATCHING NOW REQUIRED” | 


and waits on an ACCEPT. 
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If the operator enters anything other than 
AX mix-number YES 


then the utility will go to normal EOJ. If the operator enters ““YES’’. then patching will be carried out. 
The -utility displays 

“ENTER DISK IDENTITY OF FILES TO BE PATCHED”. 
and waits on an ACCEPT. | 


The operator must enter the disk name of the disk on which reside all the software files to be patched. This 
must not be the system disk. 
The utility displays © 
“FILE file-name BEING PATCHED, 
TO BE SAVED AS °*” 


and waits on an ACCEPT. 


The file-name is the name of the file to be patched, which is generated from the patch itself. This file must 
be present on the disk specified earlier. The operator must enter the new name for the file after it has been 
patched. The patched file will be retained only if the patching is successful. 


Checksums are computed and verified before and after patching. If the utility goes to EOJ without displaying 
any error messages then the patching has been successful. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ERROR IN PATCHES Keyboard input Check keyboard input 
ENTERED = RUN has been made with hard-copy» reo 
ABORTED | | in error. | execute utility. 

PATCHES T0 file- Successful patch- Make backup copy of 
namew1 SUCCESSFULLY ing run. filetname-2 Cunused 
ACCOMPLISHD AND oatched file) for future 
SAVED IN fite- patching. 

name"2 

INITIAL CHECKSUM Wrong software Remexecute utility with 
DISCREPANCY file has been correct input file. 


Submitted for 
patching- 


Other error mess” Wrong input files Request technical 
ages other serious soft- assistance. 
ware errors. 


Note: the device kind of the utility’s console file may be modified via the MODIFY utility to one of KB, 
KD or KP if required. The internal name of the console file is THREADS. 
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PMB80 (Analyze B 80 Memory Dumps) 


This utility is an interactive program which produces a formatted print of the contents of a memory dump 
tape or disk file produced by the memory dump feature of the B80 bootstrap ROM. The tape must be labelled 
““MEMDUMP/MEMORY?”’. or the disk file must be named MEMDUMP on the system disk unless otherwise 
specified to PMB80. 


The utility requires the following files on the system disk: 
PMB80 - object code file | 
PMBHELP - data file of prompt messages 
PMBERROR ~ data file of error messages 
PMBM.xxxxx - data file for information on MCP xxxxx 
PMBO.xxxxx — data file for more information on MCP xxxxx 


The x values vary with each release: the files provided with each release must be used with that release, other- 
wise incorrect analysis may be made. i | 


Starting the Utility 
The utility can be executed with a number of options in the initial message. The format is as follows: 


Format: 


AX 

SET.SCREEEN number number 
PMB80 MEMORY hex- number 

LIST 

GET file-name 

ON disk-name 


The meaning of these options is as follows: 


AX 


The program will use the SPO via DISPLAYS and ACCEPTS to communicate with the operator. If this op- 
tion is not specified the console will be used for communication. 


SET.SCREEN 


This option sets the screen page and line sizes from the numbers specified. These must be set if the DISPLAY 
option is used (see later). The input medium is the console keyboard but echoing of input is on the self-scan 
screen. 


MEMORY 


If this option is specified, the program will read only the first part of the memory dump, up to the byte given 
by the hexadecimal number. Note that use of this option could cause the program to fail on certain print options 


if the analysis requires a part of the dumped memory that has been excluded. 
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LIST 


This option will list the contents of the unanalyzed memory dump during the initial reading of the dump by 
the program. The list is in groups of 4096 (4K) bytes. | 


GET 


This option can be used to specify the name of the memory dump disk file. If not used, the file ““MEM- 
DUMP” on the system disk is opened. If this file is not present, a cassette labelled “MEMDUMP/MEMORY” 
will be opened. 


ON 

This option can be used to specify the disk on which resides the memory dump file, if not the system disk. 
Using the utility 

The analysis takes place in an interactive manner. All the available options and instructions on how to use 
them are provided in response to the input “‘HELP’’. Further details on a particular option are provided in 
response to the input “HELP option’. A knowledge of the MCP is required in order to diagnose the reason 


for any particular memory dump. 


The complete dump options are given here in “railroad diagram” format, with further details later. 


PRINT < print-option > 
DISPLAY 
CHECK - < check-option > 

AS <fid> ON <mfid> 
SAVE 


< page-option > 


PATCH < address > iz < hex-addr > 
: NEXT 


END 


BYE 
PRINT 


This option specifies that output from the following list of <print-option>s is to be printed on the console. 


DISPLAY 


This option specifies that output from the following list of <print-option>s is to be displayed on the self- 
scan screen. In this case the SET.SCREEN parameter should have been used in the initial message. 


CHECK 


The two <check-option>s are MEMORY.LINKS and ALL.MEMORY. The MEMORY.LINKS option gives 
a print of all memory links from the initial pointer (PTRX) until the end of the chain or an inconsistency is 
reached. 
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SAVE 


This option enables a copy of the dump (patched if required) to be made on the specified disk with the specified file-name. @ 
PATCH 


This option enables invalid areas of memory to be patched in the dump, to enable PMB80 to continue its analy sis. 


The <page-option> may only be ONE. The <address> is four hex digits, and the <hex-addr> may be from 
1 to 16 hex digits. 


END, BYE 
These alternative options cause PMB80 to go to normal EOJ. 


The format of <print-option> is as follows: 


ALL.MEMORY 


GLOBAL 
C.TABLE 


ESCT 
DIAGNOSTICS 
TASK.TABLE 


MEMORY.MAP , 
MEMORY LINKS 


VMWA 
GWA 


ct @ 
SAT : 
MIX 


OL 
DATA.COMM.AREA 


PHT 


< device option > , 


SLICE 


< slice option > DATA.SEGMENTS 


< task-name > 


< mix-number, 0-15 > 
} < wa option > 
CURRENT 
HEX To. < start address > —— <length> 
| <page option> | 7 
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ALL.MEMORY 

This option creates an analysis of fixed MCP data areas, configuration table and task table if present, all pe- 
ripheral handler tables, memory links and analysis of all locked slices in memory plus all overlayable code and 
data segments present in memory at the time of the dump. 
GLOBAL 

This option creates an analysis of the fixed MCP data areas only. 
C.TABLE 

This option gives a print of the configuration table if it was in memory at the time when the dump was taken. 
ESCT 

This option gives a print of the mix table (execution scan priority table). 
DIAGNOSTICS 

This option gives a print of the MCP’s diagnostic buffer area. 


TASK.TABLE 


This option gives further analysis of the mix, if the overlayable task table was present in memory at the time 
when the dump was taken. 


MEMORY.MAP 

This option provides an analysis of the layout of memory. 
MEMORY.LINKS 

This option analyses the layout of the overlayable area of memory. 
VMWA 

This option gives a print of the virtual memory work area only. 
GWA 

This option gives a print of the Global work area only. 
SCL 

This option prints the keyboard buffer only. 
SAT 

This option gives a print of the Slice Address Table snl: 
MIX 


This option gives a selective analysis of parts of the dump relating to the tasks running at the time of the dump. 
OL | | 


This option provides a-selective analysis of peripheral configuration information. 
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DATA.COMM.AREA 


This option prints the areas of memory relating to data communications. _ | | | : © 
PHT | 


This option gives a print of selected Peripheral Handler Tables. If the <device option>s are absent, then 
all peripherals attached to the system at the time of the memory dump are analyzed. Allowable values for <de- 
vice option> are: 


LP - Line Printers 

SP — Serial (console) Printer 

CT — Cassettes 

DK —- Cartridge Disks 

DF — Fixed Disks 

DM - BSM Disks 

KB — Keyboard 

SS - Self-Scan 

ADC - Asynchronous Data Comm Controllers 
SDC - Synchronous Data Comm Controllers 
DI - ICMDs 


SLICE 


This option provides selective printing of locked slices of memory or of data segments. The <slice-option> 
may be either a “slice number” in the range 0-45 or one of the following names: 


DISKDDR | © 
LPDDR | | . | 
PANDDR 

KBDDR 

CASSDDR 

SENDDR 

CONSOLE 

INXS 

SCREENSN 

SUSN 

INITIALIZE — 

ADCDDR 

SDCDDR 

OPENCLOSE | 

DCCH 

SPO 

CONBUFSN 

SCLBUFSN 

ICMDDDR 
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TASK 


.. This option prints the contents of a Task Control Block (TCB). 
The <task-name> may be one of 
NDL | | 
MCS 
BAILIFF 
SCL 
LOADER 


The <wa-option> may be one of 
MPLII 
BIL 
COBOL 
RPG 
SORT 
NDL 


HEX 


This option provides a print (or display) in hexadecimal and byte format of selected parts of memory. The 
<start address> is a four-hex-digit number and the <length> is also specified as a four-hex digit number. 


| Example: 


To obtain a complete memory dump print on the console printer: | 
PMB80 (OCK) 
PRINT ALL.MEMORY (OCK) 


To obtain a dump of the data,comm buffers, plus the data comm controller device-dependent routines, plus 
the MCS and NDL task tables: 


PMB80 (OCK) 

PRINT DATA.COMM.AREA (OCK) 
PRINT PHT ADC SDC (OCK) 
PRINT TASK MCS NDL (OCK) 


Note: 


When submitting memory dumps for analysis, it is helpful if some preliminary analysis has already been per- 
formed. The following option is recommended: 


PMB80 
PRINT MIX OL MEMORY.MAP MEMORY.LINKS GLOBAL PHT 


Always provide the MEMDUMF file on magnetic media even if this preliminary analysis has been performed. 
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POWER OFF 


Logically power off all user disks (see PO command if under MCP control, or S.A.U. PO command if under 
S.A.U. control). 


Logically power off the system disk oo PO command if under MCP control). Wait until the system returns 
to the initial state, that is PK1 and PK2 are lit. 


If the PO command cannot be used, due to some eaten error, then the system should be halted by pressing 
the Load Enable button, causing the system to return to the initial state with PK1 and PK2 lit. 


Remove all removable disk media. | 
A mini disk can be removed immediately the unit door is opened. 


A disk cartridge can be removed only when the red stop light is lit, assuming that the drive is functioning 
correctly. 


Power off the disk units (failure to remove disk media before this, may result in subsequent media corrup- 
tion). 


Remove all cassettes from the system. 
Power off the main cabinet (this must be the LAST action after all peripherals have been switched off). 
Note on disk removal: 


There are only two situations when it is valid to remove a disk: 
where the MCP is not running and the disk is not in use. 


where the MCP is running, but the disk is a user disk which is logically powered off after using the PO 
command: note that the. PO command does not cause a disk to become logically powered off if it is in 
use, but the PO will be completed only after all activity on the disk is complete. 


Note on power failures: 


If the main cabinet is switched off accidentally (for example, by power failure), remove all disks and cassettes 
before it is switched back on. 
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SECTION 9 
B 800 DEPENDENT ROUTINES 


GENERAL 


This section describes the routines that are executed on the B 776/B 800 hardware only. These routines will 
cold start a CMS system disk for B 776/B 800 systems, will warm start an existing CMS system disk, and are 
dump analyzers for the dump files on disk created by the Operating system on B 776/B 800 systems. 


CREATE 


The CREATE program will load the release tape to create a TOTALDISK. Since the TOTALDISK is also 
released with the release tape, this routine is only necessary if the release disk (TOTALDISK) can not be used 
locally due to a read error. 


SET-UP PROCEDURE 


Before loading the bootstrap loader, perform the following steps to enable loading CREATE: 

1. Depress tape unit POWER switch to power up unit. 

2. Mount release magnetic tape on a tape drive. Bring tape to BOT marker by depressing the LOAD switch 
on the tape unit twice in succession. 


OPERATING INSTRUCTIONS 


To load the bootstrap loader: 

1. Depress the LOAD/NORMAL pushbutton on the CPU. It should be illuminated red for load. 

2. Depress the system CLEAR pushbutton. 

3. Start papertape reading by depressing upper rocker of memory loader switch and inserting paper. The pro- 
gram on papertape is loaded in memory starting at location 0000. 

4. After papertape loading is complete, depress the LOAD/NORMAL pushbutton on the CPU to return to 
normal mode (it should be illuminated white). 

. Depress the system CLEAR pushbutton. 

. Depress the READY pushbutton or the INPUT REQUEST on the operator console. 

. Depress the numeric key whose number corresponds to the tape port, to load CREATE; or the disk port 
to load DSKGEN. If the port number is greater than 9, depress J, K, or L for port numbers 10, 11 and 
12 respectively. 


SIN WN 


BOOTSTRAP ERROR HANDLING 


. If a disk error occurs during execution of the bootstrap, the program waits with the disk status in MIR. 

. If a tape error occurs during execution of the bootstrap, the program waits with the tape status in MIR. 

c. If a fatal hardware error occurs during execution of the bootstrap, the program halts with the error number 
in MIR. Successive force stepping of the program will place the contents of MPCR and BMAR in MIR. 

d. If a disk error occurs while DSKGEN is loading (system loader) the program waits with the disk status 
in MIR. 

e. If a fatal error occurs while DSKGEN is loading (system loader) the program waits with the error code 

in MIR. 


Ss & 


Operating in CREATE mode, the disk cartridge on unit 1 of drive 1 will first be initialized. If no bad sectors 
are found, the DSKGEN segments will be read from tape and written to disk, followed by the RELEAS, 
FIGTRE, NAMESS, and LETTER files. The actual start and stop disk address of each file will be printed on 
the operator’s interface device when the entire segment or file has been successfully written to disk (see figure 
9-1). , 
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6 
BOI CREME 


DATE (MMDDYY) 2 042977 
LiSkK PORT # Lu 4 
INITIALIZING DISK 
INLVIGLIZE COMPLETE 

SG 65 COLE 00816 LOADED 
SEG OO COOL? 0039 LOADED 
SEG OL OOS9 OO8R  LOAGED 
Gl O82 OO3C 0044 LOAD 
SEG O8 0045 O046A LOATIED 
SIG O4 004B OO4KF LOADED 
Gh OF OOSO OO87  LOAGIZD 
SEG O4 COSB OO60 [OAT 
SG OF OOSL GO71 LOAD 
SEG O8 CO7P OO74 LOADED 
SEG OF OOF OORE LOADED 
SEG OA CO8F 0094  LOADITD 
SEG OB EOS OO89 LOAKED 
SEG OC OOFA OOA7 LOADED 
SEG OD COAG OOAC LOADED 
SEG OF OGAD OOBL LOADED 
ey OF CORP OOB3B LOADED 
SEG LO OOR4 OOBR LOADED 
SEG LL OOB9 OOCS  LOAGED 
RELEAS 60C6 1F8D LOADED 
FIGTRE LERBE LF9D LOADED 
NAMESS LE9E FBS LOADED 
LETTER 1FB6 2275 LOADED 


EOI CREATE 


: Figure 9-1, Sample CREATE Printout 
ERROR MESSAGES AND RECOVERY 


The following is a summary of tape and disk error messages of conditions which can occur while operating 
CREATE. 


| ERROR PRINTOUT PROBABLE CAUSE , OPERATOR ACTION . 


TAPE LABEL ERROR 
C OR P NOT SPECIFIED ERROR 


File-ID is not ‘“GENSYS” 


User’s portion of label does 
not contain a C or P in 
position 81. 


DSKGEN loader (Seg 63) 
was not the first DSKGEN 
segment read from tape. 


These errors indicate a tape 
format error in the release 


tape 


Reload program from 

bootstrap and allow one 
retry. If unsuccessful, a new 
tape will have to be used. 


DSKGEN FILE ERROR # x 


DSKGEN INDEX ERROR * * DSKGEN segment - was not 


between () and 22. 


A Service Too Late, Parity 
Error, or Tape Error has 
been detected. 


TAPE READ ERROR * * 


TAPE NOT READY ERROR Tape unit is not ready to 
accept a command from the 


processor. 


Reload program from 
bootstrap 


TAPE ERROR MESSAGES , 


DISK ERROR MESSAGES 


ERROR PRINTOUT PROBABLE CAUSE OPERATOR ACTION 


BAD SEG - CANNOT BE A bad sector has been found 1. Re-try CREATE. 
TOTALDISK during initialization. 2. Try another cartridge. 


3. Check for proper 
functioning of the disk unit. 


NOTE: 

The above error condition 
may indicate a serious 
misalignment of the 
cartridge. Do not attempt 
more than one retry with the 
same cartridge, otherwise the 
read/write heads may be 
damaged. 


NO AVAILABLE DISK ERROR x 
x 


DISK NOT READY 


No more space on disk for 


Technical assistance required. 
files. 


Disk unit unable to accept 
commands from processor. 


Ready disk unit. 


ADDR DISK ERROR x x 1. Bad sector on disk 
cartridge; Operate-Compare 
successful but returned 
address incorrect. 


2. Illegal track address. 


1. Initialize cartridge. 
2. This error usually 
indicates a firmware or 
hardware malfunction. 


DVCE DISK ERROR x x 


Status error in disk unit 
which firmware does not 
recognize. Disk unit, 
processor or firmware error. 


1. Ready unit and retry. 


FILE DISK ERROR x x 1. Disk unit not operational. 
| 2. Write lockout on disk 
drive. 

3. Cable connector to disk 


unit not properly seated. 


. Ready unit. 
. Enable write on cartridge. 
. Ensure proper connection 
to disk unit. 


QN — 


PRTY DISK ERROR During any phase of 
initialization indicates an 
LRC read error on the 


cartridge. 


A re-try of the operation 
may be successful, however, 
a true LRC error means that 
the cartridge is no longer 
usable. First determine that 
the disk unit is operating 
properly before attempting 
retry. 


SEEK DISK ERROR x x Seek error on disk unit. Techniocal assistance 


required. 


CREATE source may be 
faulty try again. 


SERV DISK ERROR x x Service late on disk read or 


write. Disk unit, processor, 
or firmware error. 


TIME DISK ERROR x x Instruction timeout on disk 
unit. Can be caused by 
hardware malfunction or bad 


cartridge sector address. 


1. Disk cartridge may 
require initialization. 
2. System clear button 
should be pressed. 


DISK GENERATOR 
GENERAL DESCRIPTION 


The Disk Generator program (DSKGEN) can perform the following functions: 
a. Initiate unit 1, drive 2 and build the initial CMS directory. 

b.Execute a system generation in either prompting or no-prompting mode. 

c. Copy from any drive to any other drive. 

d. Warmstart the user system cartridge. 

e. Print the release letter on the operator console, or line printer. 

f. Replace firmware segments and programs on the user system cartridge. 
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The individual functions are described in detail in the following sections. | 


The disk generator program consists of 18 code segments. DSKGEN is microprogrammed for speed and access 
to all areas of disk. The System Loader resides at track 0, face 1 on TOTALDISK and is read into memory 
using the bootstrap papertape. After load time, always resident in core are: 256 registers; ACOMMON (which 
consists of a manager routine, input/output control, read/write routines, accept/display routines, etc.); a disk 
controller and a SPO or console controller. The overlay region is used for various functions by DSKGEN, in- 
cluding: | 
. Initial setup procedures. 

. Disk initialization and build CMS directory code. 
Disk generation in prompting or no-prompting code. 
Copy disk to disk. 

. Bootstrap to warmstart. 

Fatal error routines. 

. Printing the LETTER file. 

. Patching the user’s system cartridge. 


soe moans 


It is important to realize that disk accesses are necessary to perform the functions of DSKGEN. Only remove 
TOTALDISK at the appropriate times as specified in the operating instructions. 


OPERATING INSTRUCTIONS 


1. Execute the DSKGEN bootstrap loader. 
2. Depress the READY button or the INPUT REQUEST key on the operator console to define to tlie pro- 
gram which device is on the particular system. 
3.Index the numeric port number for the disk unit. The bootstrap will now wait if the disk unit is not ready, 
then proceed to the DISKGEN code segments. 


| NOTE 
If any error occurs in the above sequence, return to Step 1. 


4. DSKGEN will print: 
B 700/B 800 SYSTEM DISK GENERATION 
ENTER DATE (MMDDYY) 
Enter the six-digit date. 
DSKGEN will print: 
ENTER TIME (HHMM) 
Enter the time. 


NOTE 
Date will be syntaxed for validity and the message repeated if invalid. Time will be 
syntaxed for valid numerics. 


5. DSKGEN will print: 

1 INIT 

2 DSKGEN 

3 COPY 

4 BOOT | 

5 LETTER 

6 PATCH 

SELECT 
Select the option by entering a number 1-6. The message will be repeated for an invalid selection. This is 
referred to as the SELECT routine throughout the rest of the instructions. 


The selected routine Initialize, System Generation, Copy, Bootstrap, Letter, or Patch will now be loaded from 
disk and begin execution. The routines are described below. 


INITIALIZATION ROUTINE (INIT) 


Before selecting Option 1, the user must first install a scratch disk cartridge in unit 1, drive 2. The option 
will then cause the program to print “INITIALIZING DISK” and begin initializing the cartridge. If a disk car- 
tridge is not present, or is not write enabled, this will result in a disk error message and return to the SELECT 
routine. After the disk is initialized, CMS directory will be built and then return to the SELECT routine after 
printing any bad segments found (up to 50 bad segments are allowed for a system disk). Other messages should 
be handled as previously described under disk error messages. 
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After an CMS disk has been initialized, there will follow a series of displays to the operator for which re- 
sponses are required to specify disk directory size and cartridge label fields. 


Operating procedures for the Question-Answer routine are as follows (responses must be directed to the al- 
phanumeric keyboard if entered on an electronic console): | 

I. “ENTER NO OF TRACKS FOR DIR (1-9):” will print. Only a numeric response from 1-9 will be al- 
lowed, with the resulting directory format given in table 9-1, Directory Format Table. 

2. “ENTER SERIAL NUM77 will print. One to six numeric keys (0-9) on the alpha keyboard must be en- 
tered. 

3. “ENTER PACK ID” will print. One to seven valid alphanumeric characters must be entered. 

4. “ENTER OWNERS ID” will print. One to fourteen valid alphanumeric characters must be entered. 


Requested Tracks (Sectors) Directory (File) Entries 


1 (32) 
2 (64) 
3 (96) 
4 (128) 
5 (160) 
6 (192) 
7 (224) 
8 (256) 
9 (288) 


Table 9-1. Directory Format Table 


Available Entries 


SYSTEM DISK GENERATION ROUTINE (DSKGEN) 


If Option 2 is selected, the system disk generation procedure will be entered, starting with a Question-Answer 
routine in which the user can specify which operating mode prompting or no-prompting will be used for the 
disk generation. In both methods, selections of the subsystems to be loaded to the user’s system disk are made 
by entering the subsystem numbers via the keyboard. 


As part of the release procedure, the subsystems are assigned into three groups: choices, exclusive options, 
and options. The number of allowable selections from any one group of subsystems depends on the type of 
the subsystem group. When only one subsystem must be selected from the subsystem group, this is a choice. 
When only one subsystem may be selected from the subsystem group, this is an exclusive option. When any 
number of subsystems may be selected from the subsystem group, this is an option. The choices, options, and 
exclusive options are predetermined. In prompting mode, subsystem groupings are printed for the user and each 
selection is syntaxed as it is made. In no-prompting mode, selections are syntaxed after all entries are complete. 
The first selection of both prompting and no-prompting is always the selection of the system to be generated. 


QUESTION-ANSWER ROUTINE 


Operating procedures for the Question-Answer routine are as follows: 
1. “RESPOND TO QUESTIONS WITH 1 FOR YES AND 2 FOR NO” will print. 
2. “FE MODE” will print. If a user requires a listing of the segment type, segment name, and segment load 
address, the response should be a 1, otherwise a 2. 
3. “DO YOU REQUIRE PROMPTING?” will print. The user should respond 1 or 2. 
4. If the user responds YES to prompting, the following will print: 
PLEASE CHECK DRIVE 2 FOR 
SCRATCH DISK PRESENT 
DISK DRIVE ON 
DISK WRITE ENABLED 
ARE DISKS READY? 
When all conditions are true, the user should respond 1. | 
5. If the user responds NO to the Step 3 prompt, then the message “ARE DISKS READY?” will print. 
If the scratch disk is present, on, and write enabled, the user should enter a 1. | | 
6. “INITIALIZING DISK” will print. At this time the scratch disk will be initialized. If any errors occur 
during initialization the appropriate error message will be displayed. | 
The same Question-Answer routine as described for INIT will be entered, requiring the same operator re- 
sponses as specified therein. 
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PROMPTING MODE OPERATING INSTRUCTIONS 
Il. “SELECTIONS ARE MADE BY ENTERING THE 4-DIGIT SUBSYSTEM NUMBERS” will print. 


2. System Selection: 


a. “SELECT SYSTEM:” will print followed by the valid system numbers and system names to be selected. 


b. 


“SELECTION OOL” will print. The user should respond by entering one of the system numbers. If an 
invalid selection is made, an appropriate error message will appear. “SELECTION 001” will print. The 
user should re-enter a valid system number; the previous selection is ignored. 


3. Subsystem selection: 


a. 


If selection is a choice, “YOU MUST SELECT (ONLY) ONE OF:” will print followed ny the group 
of subsystem numbers and subsystem names to be selected. : 


I selection is an exclusive option, “YOU MAY SELECT (ONLY) ONE OF:” will print followed by 


the group of subsystem numbers and subsystem names to be selected. The last selection to print will 
be “9999 NO SELECTION”. 


. If selection is an option, “YOU MAY SELECT ANY NUMBER OF:” will print followed by the group 


of subsystem numbers and subsystem names to be selected. The last selections to print will be ‘9998 
ALL SELECTIONS” and “9999 END SELECTION”. 


“SELECTION XXX” (where XXX = the number) will print. XXX is incremented by one before dis- 
play. 


. [f selection is a choice, the user should enter the subsystem number from the group of choices displayed. 


If an invalid selection is made, the appropriate error message will appear and “SELECTION XXX” 
(XXX will not change) will print again. The user should re-enter a valid selection; the previous selection 
is ignored. When a valid selection is entered, the object code for that subsystem is then loaded to disk. 


. If selection is an exclusive option, the user should enter a subsystem number from the group of exclusive 
options displayed or a “9999” if no selection is to be made. If an invalid selection is made the appropriate 


error message will appear and “SELECTION XXX” (XXX will not increment) will print again. The user 
should re-enter a valid selection; the previous selection is ignored. When a valid selection is entered, 
the object code for that subsystem is then loaded to disk. 


. If selection is an option, the user should enter the subsystem number(s) from the group of options dis- 


played, or a ‘‘9999” if no selection is to be made, or a ‘*9998” if all selections are to be made. If an 
invalid selection is made, the appropriate error message will appear and “SELECTION XXX” (XXX 
will not increment) will print again. The user should re-enter a valid selection; the previous selection 
is ignored. When a valid selection is entered, the object code for that subsystem is then loaded to disk. 
“SELECTION XXX” (XXX has been incremented by 1) will print. If another selection is to be made, 
enter the next subsystem number. Duplicate selections will be ignored. When all subsystems have been 
selected from the group, enter a ‘‘9999” to end selections for that group. 


. Procedures for subsystem selection will be repeated until all subsystems have been selected. The message 


“SYSTEM DISK COMPLETE XX:XX” will print, where XX:XX represents the time. “SELECT” will 
then print, meaning that the user has been returned to the Select routine. 


PROMPTING ERROR MESSAGES 
“ERROR —- NOT A SYSTEM” 


The first selection ts not a system. 
“ILLEGAL SELECTION” 


The selection made is an invalid, selection for that group of systems. The user shouid make another selection. 
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B700 SYSTEM DISK GENERATION 
RELEASE 1276 


ENTER DATE CMMDDYY) 122976 
HAPPY HOLIDAYS 

ENTER TIME CHHMM) 1346 
L INIT 


2 DSKGEN 
3 COPY 
4 BOOT 
© LETTER 
4 PATCH 
SELECT 2 


SYSTEM DISK GENERATION 133246 


RESPOND TO QUESTIONS WITH 1 FOR YES @ FOR NO 
FE MODE? 2 
DO YOU REQUIRE PROMPTING? 1 
SYSTEM WILL BE GENERATED ON DRIVE B 
PLEASE CHECK DRIVE B FOR 
“SCRATCH DISK PRESENT 
“DISK DRIVE ON | 
“DISK WRITE ENABLED 
ARE DISKS READY? 1 


INITIALIZING DISK 

ENTER NO OF TRACKS FOR DIR (2-9) 2 8 

ENTER SERIAL. NUM 133799 

ENTER PACK ID REL.B? 76 

ENTER OWNERS TD TIODTN 

SELECTIONS ARE MADE BY ENTERING A 4-DIGIT SYSTEM NUMBERS 


SELECT SYSTEM: 
0037 CMS-SYSTEM 


SELECTION 001 0057 CMS-SYSTEM 


YOU MAY SELECT ANY NUMBER OF: 

O00] MPLo-COMPILER 0013 COBOL~—COMPILER OO23 RPG-COMPILER 
0036 NDL-COMPILER 0040 PSL~COMPILER 0044 SQMCS—- PROGRAM 
0046 CMCS--PROGRAM 0043 NDL-~SAMPLE 9998 ALL SELECTIONS 
2999 END SELECTION 

SELECTION O02 O001 MPL2-COMPILER 

SELECTION O03 0013 COBOL~COMPILER 

SELECTION 9004 0023 RPG-COMPILER 


SELECTION 005 9999 
SYSTEM DISK COMPLETE 13233 


Figure 9-2. Sample DSKGEN, Prompting Mode 
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NO-PROMPTING MODE OPERATING INSTRUCTIONS 


1. Upon entering no-prompting mode, the following instructions will be displayed: @ 
9999 —- ENDS SELECTION : 
9998 - INCLUDES ALL OPTIONS 
1ST SELECTION MUST BE A SYSTEM 

2. The above information is followed by a display of the hesciie: format to be used in the selection process: 
SELECTION - SS-NO DESCRIPTION YES-NO? 

3. The system selection process will then commence: 

a. “001” will print under SELECTION. 

b. The user should enter the system number of the system to be coldstarted. 

c. The system name will print under DESCRIPTION and the printing element will proceed to the YES- 
NO column. 

d. If the selection is correct as displayed, enter a “1”. under YES-NO. If the selection must be changed 
or corrected, enter a ‘‘2”” under YES-NO; the printing element will proceed to the next line, print 001 
(SELECTION - remains the same), and.a new selection can be made (previous selection is ignored). 

e. Following the entry of a “1” (YES response) the selection will be checked for validity. If an invalid 
‘system selection was made, an appropriate error message will be printed and the procedure will return 
to the “001” selection state. This process will continue until a valid selection is made or the procedure 
is terminated. 

4. Following successful system selection, the procedure then proceeds to subsystem selection: 

a. The print element returns to the SELECTION column, and the selection number is printed incre- 
mented by one. 

b. Select appropriate subsystem(s): 

1) Enter “9998” if all options are to be included; or 
2) Enter subsystem selections individually. | 

In either case, the printing element will proceed to the YES-NO column after the selection is made. Enter 
a ‘1” if the entry is correct, or a “2” if the subsystem number requires correction. If a “1”, the SELEC- 

TION will be incremented allowing additional subsystem selections to be made; if a “2”, the same selec- 

tion number will be repeated. 

c. Terminate the selection routine by entering “9999”. _ 

5. The object code for all selected subsystems is loaded to disk, providing that the selection is valid. 

6. If an invalid subsystem number is detected, the subsystem number and appropriate error message will print. 

7. The message “SYSTEM DISK COMPLETE XX:XX” will print, where XX:XX represents the time in 
hours and minutes of the day. 

8. The message “SELECT” will print, notifying the user that control has been returned to the Select routine. 


NO-PROMPTING ERROR MESSAGES 


“ERROR - NOT A SYSTEM” 
The first selection is not a system. 
“ILLEGAL SELECTION” 
The selection made is an invalid selection for the system being generated. — 
“AMBIGUOUS SELECTION - IGNORED” 
More than one choice or option of the same group was entered. The second one was ignored. 
“XXXX DUP SELECTION - IGNORED” 
Duplicate selection, where XXXX is the subsystem number. Identical sclecuons were made. The second 
one was ignored. . 
“ROD CHOICE XXX NOT MADE” 
Required choice not made, where XXX is the choice number. A required subsystem was not entered. Sys- 
tem disk will not be generated. 
“SEL TABLE FULL” | 
Selection table full (100 selections allowed per system generation). 


COPY 


If Option 3 is selected, the program will print messages prompting the user for the source and destination © 
drive numbers. To return to the SELECT routine enter zero, (0 from the alpha keyboard) for the source drive. 
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DCO SYSTEM DISK GENERATION 
RELEASE 2276 


ENTER DATE CMMDDYY) 120974 


PAPPY HOLL TDAYS 
ENTER TIME CHHMM> 1387 

Lo oSNIT | 

2 RSKGEN 

w COPY 

& BOOT 

= LETTER 

o& PATCH 
SELECT 2 


SYSTEM DISK GENERATION 13:57 


RESPOND TO GUESTIONS WITH 1 FOR YES @ FOR NO 
rE MODE? 2 

DO YOU REQUIRE PROMPTING? 2 

GRE DISKS READY? 1 


ENT TITALILZING DISK 

ENTER HO OF TRACKS FOR DIR ¢1-9)8 9 

ENTER SERTAL HUM L33790 

EATER PACK TD RELB?774 

ENTER OWNERS ID TIODTN 

2999 ENDS SELECTIONS 

998 INCLUDES ALL OPTIONS 

197 SELECTION MUST BE A SYSTEM 

SELECTION % So NO DESCRIPTION YES-NO? 


OO1 OOS7 CMS-SYSTEM 1 
OO? O00] MPLa-COMPILER 1 
OOS 0013 COBOL-COMPILER 1 
O04, O025 RPG-COMPILER 1. 
OOS 0036 NDL-COMPILER 2 

OOS 9999 | 
SYOTEM DISK COMPLETE 14204 


a 


Figure 9-3, Sample DSKGEN, Prompting Mode 
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In order to prime the CMS destination cartridge label, copy will print the following: 
a. For Copying TOTALDISK: © 
SOURCE DRIVE A-H (0 TO TERMINATE: A 
DESTINATION DRIVE A-H: B 
ARE YOU COPYING TOTALDISK? | 
COPYING : 
SOURCE DRIVE A-H (0 TO TERMINATE): O 
b. For Copying a CMS System Disk: 
SOURCE DRIVE A-H (0 TO TERMINATE): A 
DESTINATION DRIVE A-H: B 
ARE YOU COPYING TOTALDISK? 2 
ENTER PACK ID ABCDEFG 
ENTER OWNERS ID ABCDEFG12345 
COPYING | 
SOURCE DRIVE A-H (0 TO TERMINATE): O 
_ The expected responses to the “ENTER PACK ID” and ‘ENTER OWNERS ID” displays are as described 
for those fields in INIT Question-Answer Routine. 


TOTALDISK may be removed during this process but must be replaced before entering “0”. A disk error 
message will result if a disk cartridge is not present or if a disk error occurs. A new cartridge must be initialized 
before being copied to. A cartridge with any bad sectors cannot be used in COPY. 


COPY performs a disk-to-disk copy of the first 203 cylinder of the source disk. A read-after-write check is 
done for each track. If the validity check fails, a message “COPY ERROR XXXX” will be printed (where 
XXXX = disk address). Since DSKGEN is limited by the virtual machine, the copy is a full copy on a single 
density drive and a half copy on a double density drive. This is sufficient to copy TOTALDISK and any new 
users system disk but should not be used to copy double density data platters. 


NOTE | 
DSKGEN can be used to create copies between single and double density drives 
of TOTALDISK and the users system cartridge, but it should be realized it is the 
directory information of the original disk that will govern the limits of the second © 
disk. 


- BOOTSTRAP WARMSTART 


In CMS the system disk may be placed on any unit and drive. When the system disk is ready, the operator 
will enter the desired drive. The warmstart routine will be read from the specified disk and begin execution. 
The typical printout is as follows: 


BOOTSTRAP WARMSTART 

REMOVE TOTALDISK 

PLACE SYSTEM DISK ON DESIRED DRIVE 
ENTER DRIVE NUMBER (A-H) WHEN READY 


NOTE 
Unless TOTALDISK is removed before a CMS Warmstart,. it will be destroyed. 


RELEASE LETTER 
GENERAL DESCRIPTION 


The release letter which always accompanies a release may be printed for the user’s benefit. If the user does 
not specify a dump to the line printer, the letter is automatically dumped to the console. If the line printer 
is selected, and an error occurs, ‘““LINE PRINTER ERROR” will print and the program will return to the SE- 
LECT routine. At the end of the dump of the letter file, the program will return to the SELECT routine. 


OPERATING INSTRUCTIONS 


1. “DO YOU REQUIRE A PRINTER LISTING” will print. 

2. User responds “1” (YES) or “2” (NO). 

3. If YES, “PRINTER PORT ” will print. 

4. User should enter printer port number. The line printer should be ready. 
5. If NO, the letter will begin printing on the console. | 
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PATCH 
GENERAL DESCRIPTION 


The function of the patching capability is to replace firmware segments of code files, and programs on a user’s 
system cartridge. The user selects the segments, files, or programs that he wishes to replace. There are two 
restrictions when patching code segments: (1) The selected segment to be patched must be present on the user’s. 
system cartridge and (2) there must be enough disk area to load the patched segment into the same disk area 

_as the selected segment. When patching programs and files, if the selected program or file is present on disk, 
that program or file will be purged first and then the patched program or file will be loaded. If the selected 
program or file is not present on disk, the patched program or file will be loaded to disk. The user should 
be aware that if the disk space cannot be found for the patched program or file, it will not be loaded and the 
previous program or file has been purged. This is a very important aspect when patching subsystems pf programs 
and files; for example a compiler, because some programs and files of that subsystem possibly will not be 
loaded. In some cases, the selected program or file cannot be purged, therefore the user’s disk is left unchanged 
and a message is displayed to inform the user. 


There are two modes of patching, prompting and no-prompting. In the prompting mode, a list of segments, 
subsystems, programs, and file names along with their appropriate subsystem number are displayed for the sys- 
tem to be patched. In the no-prompting mode no list is displayed. Selections are made by entering the 4 digit 
subsystem number. In both modes the first selection must be a system selection. 


OPERATING INSTRUCTIONS 


1. Upon entering patch the following instructions will be displayed: 


RESPOND TO QUESTIONS WITH 1 FOR YES 2 FOR NO 
SELECTIONS ARE MADE BY ENTERING 4-DIGIT SYSTEM NUMBERS 
DO YOU REQUIRE PROMPTING? 


. Enter a 1 (yes) or 2 (no) 

. If a 1 is entered: | 

a. The group of system names and their system numbers will be displayed. 

b. “SELECT SYSTEM:” will print followed by the heading format below which is to be used in the selec- 
tion process. 


SELECTION - SS-NO DESCRIPTION YES-NO? 


WN 


c. ‘001 will print under selection . 

d. The user should enter the system number of the system to be patched. 

e. The system name will print under DESCRIPTION and the printing element will proceed to the YES- 
NO column. , 

f. If the selection is correct as displayed, enter a “1” under YES-NO. If the selection must be changed 
or corrected, enter a “2”? under YES-NO; the printing element will proceed to the next line, print 001 
(SELECTION - remains the same), and a new selection can be made (previous selection is ignored. 

g. Following the entry of a “1”? (YES response) the selection will be checked for validity. If an invalid 
system selection was made, an appropriate error message will be printed and the procedure will return 
to the “001” selection state. This process will continue until a valid selection is made or the procedure 
is terminated. 

h. All segment, subsystem, program, and file names of the selected system along with their appropriate 
subsystem number will be displayed followed by the message ‘9999 ends selections’’. 


4. If a 2 is entered: 
a. The following instructions will be displayed: 


IST SELECTION MUST BE A SYSTEM 
9999 ENDS SELECTIONS 


b. The above information ts followed by a display of the heading format to be used in the selection process: 
SELECTION - SS-NO DESCRIPTION YES-NO? 

c. “O01” will print under SELECTION . 

d. The user should enter the system number of the system to be patched. 

e. The system name will print under DESCRIPTION and the printing element will proceed to the YES- 
NO column. | 
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f. If the selection is correct as displayed, enter a “1” under YES-NO. If the selection must be changed 
or corrected, enter a “2” under YES-NO; the printing element will proceed to the next line, print 001 
(SELECTION - remains the same), and a new selection can be made (previous selection is ignored). 

g. Following the entry of a “1”? (YES response), the selection will be checked for validity. If an invalid 
system selection was made, an appropriate error message will be printed and the procedure will retura 
to the “001” selection state. This process will continue until a valid selection is made or the procedure 
is terminated. 


5. Following successful system selection, the procedure then proceeds to the selection routine: 

a. The print element returns to the SELECTION - column, and the selection number is printed incre- 
mented by one. 

b. The user should enter the subsystem number of the program, file, subsystem, or segment to be patched. 

c. The printing element will proceed to the YES-NO column after the selection is made. Enter a “1” if 
the entry is correct, or a “2” if the subsystem number requires correction. If a “1”, the SELECTION 
* will be incremented allowing additional subsystem selections to be made; if a ‘‘2’”’, the same selection 
number will be repeated. : 

d. The selection will then be syntaxed for validity and patchability. If patchable and valid, the patched seg- 
ment, program or file will replace the present code on disk and a message will be displayed to inform 
the user. If the selection is not valid or patchable, the appropriate message will be displayed to inform 
the user. 

e. Terminate the selection routine by entering “9999”. The message “SELECT” will print, notifying the 
user that control has been returned to the select routine. 


ERROR MESSAGES AND RECOVERY 
FATAL ERROR MESSAGES 


The occurrence of a fatal error condition while operating DSKGEN will cause a branch to the fatal error 
routine, resulting in an error alarm, an error printout and display, and a program halt. | 


Recovery may be possible from some fatal error conditions by attempting to re-run the program; however, 
if recovery fails after repeated re-tries (one re-try for hardware errors), the operator has no recourse other than 
to obtain technical assistance. When a fatal error condition is detected, the system will respond in the following 
manner: , 


peed 


. The FATAL error routine segment will be loaded from TOTALDISK ‘to program memory if not already 
resident there. | | | 

. The console ERROR indicator will be turned on. 

The console audible alarm will be sounded. 

. The “D” indicator bank will display the binary value of the error type. 

. The appropriate error message will be printed on the console. 


HARDWARE FATAL ERRORS 


The console message format for a hardware fatal error condition is: 


(REASON FOR ERROR) AAAA BBBB- CCCC DDDD 
| eer - MIR MPCR BMAR 
TOE eee ae Contents Contents Contents 
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A typical fatal error message format is as follows: 


NAND ADDRESS ERR ' 


ERROR MESSAGE 


““Q"’ 
INDICATOR 
PATTERN 


MEMORY ERROR 
LOADER ADDRESS ERR 
LOAD ADDRESS ERR 


LOAD MPM PARITY ERR 
NANO PARITY ERROR 


NANO ADDRESS ERROR 


MPM PARITY ERR 


MPM ADDRESS ERROR 


DPM WRITE ERR 
DPM PARITY ERR 
DPM READ ERR 


WRITE STEAL ERR 


STEAL PARITY ERR 


READ STEAL ERR 


SOFTWARE FATAL ERRORS 


The console error message format for software fatal errors is as follows: 


(REASON FOR ERROR) 


Error Message 
(See listing next page) 


FIB Description 


D-Words/ 
Segment 


8005 9001 


2020 007B 


DESCRIPTION 


Hardware has detected an error in papertape during read-in of data. 


Hardware has detected an addressing error while loading papertape; that is, an 
attempt was made to load beyond physical confines of memory. 


Hardware has detected a parity error while loading papertape. 


Hardware has detected a parity error in an MPM word while attempting to read 
a nano instruction. 


Hardware has detected an addressing error while attempting to read a nano 
instruction; that is, an attempt was made to read outside the physical confines of 
the nano memory. 


Hardware has detected a parity error while attempting to access a micro 
instruction. 


Hardware has detected an addressing error while attempting to fetch a micro 
instruction; that is, an attempt was made to execute a micro instruction outside 
the physical confines of the memory. 


Hardware has detected a memory address in excess of the memory limit register 
setting while the processor was attempting a write operation. 


Hardware has detected a parity error while the processor was attempting to read 
data memory. 


Hardware has detected a memory address in excess of the memory limit register 


setting while the processor was attempting a read operation. 


Hardware has detected a memory address in excess of the memory limit register 
setting while one of the direct memory access channels was attempting to write to 
memory. 


Hardware has detected a parity error while one of the direct memory access 
channels was attempting to read data memory. 


Hardware has detected a memory address in excess of the memory limit register 
setting while one of the direct memory access channels was attempting to read 
from memory. 


| x MPCR BMAR 
Error ee Contents Contents 


Current Records/ Segs/ 
Page Page Page 


D-Words 


D-Words/ 
Record 


Start 
Address 
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Example: 


INVALID KEY 0002 0001 1796 1002 
0001 0064 FFFF 005A 0004 0004 0598 
0000 005A 0168 0000 0000 0005 9808 


Software fatal error messages having the above format includes: 


| ERROR MESSAGE _ DESCRIPTION | 


ILLEGAL — I/O | 7 Interpreter has detected an ilegal request to an I/O device. 


INVALID KEY | An attempt was made to read an item record with a disk key 


beyond the file limits. 


In addition to containing the above formatted information, the software fatal error messages listed below also include 
FGTRE record information following the data field. The format is: 


Example: 


SEG NOR ERROR 0004 2064 1467 175A 
0031 FFFF FFFF 0020 0010 0020 0000 
0000 O00SA OAEO 0000 0000 0000 0008 


0000 0000 0000 0000 
ERROR MESSAGE ee DESCRIPTION | 
FIGTRE file contains a record type. 


INVALID TYPE 


SEG HDR ERROR Segment header error. Invalid header type has been detected. 


NO PROGRAM SEG No program segment. An attempt was made to load a program segment 


not on disk. 


POSITIONING Carrier stall was detected while positioning; carrier overspeed was detected 
while printing; or the interpreter detected as attempt to position the 
carrier beyond the limit imposed by the platen size value of the keyboard 


dataseg currently in use by the interpreter. 


STACK OVERFLOW | Occurs when choice option stack (max. 20 entries) or substyles stack 


(max. 4 entries) exceeds limit. 


Disk Error Messages 


ERROR MESSAGE | 


ADDR DISK ERROR * * * 


DESCRIPTION 


OPERATOR ACTION 


1. Initialize cartridge. 


1. Bad sector on disk cartridge; Operate- 
Compare successful but returned address _ 
incorrect. 


. [egal track address. 


2. This error usually indicates a firmware 
or hardware malfunction. | 


DVC DISK ERROR * * * _ Status error in disk unit which firmware does. 
not recognize. Disk unit, processor, or firm- 


ware error. 


Ready unit and retry. 
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FILE DISK ERROR * * * 1. Disk unit not operational. . Ready unit. 
2. Write lockout on disk drive. . Enable write on cartridge. 


. Cable connector to disk unit not properly . Ensure proper connection to disk unit. 
seated. 


INIT DISK ERROR * * * More than 50 bad segments or 9 bad areas . Retry initialization. 
have been found while initializing disk cart- 
ridge. This condition may also be caused by 
a malfunctioning disk drive. . Check for paper functioning of the 

disk unit. 


2. Try another cartridge. 


PRTY DISK ERROR * * * During any phase of initialization indicates A retry of the operation may be successful, 


an LRC read error on the cartridge. however, a true LRC error means that the 
cartridge is no longer usuable. First deter- 
mine that the disk unit is operating prop- 
erly before attempting retry. 


SEEK DISK ERROR * * * Seek error on disk unit. Technical assistance requized. 


SERV DISK ERROR * * * Service late on disk read or write. Disk unit, Create source may be faulty - try again. 
processor, or firmware error. 


TIME DISK ERROR * * * Instruction timeout on disk unit. Can be . Disk cartridge may require initializa- 
caused by hardware malfunction or bad tion. 


cartridge sector address. . System CLEAR button should be 
pressed. 


Other Error Messages 
The following error messages may appear while operating DSKGEN: 


ERROR MESSAGE DESCRIPTION 


DIRECTORY MESSAGE * * * Indicates no avilable entries in user’s protected directory for program date 
segment. IO-data or utility load. 


BAD SEGMENT: XXXX Indicates that a bad segment was detected where XX XX is the disk address. 


NOT FOR INTERPRETER USE There are bad sectors in the protected area, therefore, this disk cannot be a 
system platter. 


COPY ERROR XXXX Indicates read-after-write check failure, where XX XX is the disk address. 
LINE PRINTER ERROR Indicates that the line printer is ina Not Ready condition. 
TRACK O BAD —- DISK UNUSABLE CMS — Bad sectors in necessary disk area. 


NO ROOM FOR DIRECTORY — DISK UNUSABLE | CMS — An area on disk cannot be found to contain the disk directory of the 
size specified during initialize. 
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CMS System Disk Layout 


CMS system disk segments are divided into the following sections: 


Disk Segments 


0 Label inf ormation 
l Security Information 
2 thru. 9 B 80 Bootstrap Area 
OA thru 11 B 1700 Bootstrap Area 


12 thru 18 | | B 700/B 800 Bootstrap Area 


19 thru 1F Reserved for Operating System 


20 thru END Directory Space 
Disk File Areas 


WARM START 


The warm start procedure enables an operator to define the system configuration. The system is placed in 
a normal operating status at the conclusion of a warm start. 


The bootstrap loader (COMMON BOOT paper tape) is loaded in the same manner as in CREATE and 
DSKGEN up to the point of entering a port number. The entry is now the disk drive number A through H 
which contains the CMS system disk with a B 700MCP file. : 


WARM-START OPERATING PROCEDURE 


NOTE 
If an error condition is indicated at any time when performing the following proce- 
dure, refer to information under WARM START ERROR HANDLING, table 6- 
3, for error definitions and operation actions. 


All entries are made on the operator console. Proceed as follows: 


I. 


2. 


n 


Warm start will print the messages WARMSTART, SYSTEM PACK ID IS pack-id, and HARDWARE 
CONFIGURATION. | 7 
Enter the configuration of the system. A valid entry will consist of a two-character mnemonic (table 9- 
2), a two-character port number, and a one-character device number. The one-character device number 
has a range of A-H for all devices except DC, for which the range is 0 or 1. If two device numbers are 
entered, only the first is used except for a multiqueue device, such as disk. Blanks may be entered at any 
time. Only 40 characters are valid per entry. | | 
NOTE 
If an error has occurred during warm start, one of the error messages will be printed 
on the operator console. The entire configuration of the system must be reentered. 


. Termination of any entry is made by pressing END OF MESSAGE pushbutton or the OCKI on the nu- 


meric keyboard. 


If an entry is not complete, and an error has been made. pressing the ERROR or RESET button will 
allow a recreation of that entry. 


. When configuration is complete, END must be entered to allow warm start to continue. 
- To the question DUMP FILE? a YES or NO must be entered. A YES response will cause a file named 


DMFILO0 to be created on the system disk cartridge. Also, disk space will be allocated to DMFILOO equal 
to the size of the main memory of the system. In the unlikely event of a processor or system firmware 
failure (for example, Memory Address Error) the MCP will store the contents of main memory to 
DMFILO0. When the system is restored, see clear start, the operator should execute the utility SYSDUMP. 


SYSDUMP will convert the dump file to a formatted listing which will be of use to support personnel. 
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A NO response will remove an existing DMFILOO em the system disk and return the disk space to the 
available directory. 

7. Message ENTER DATE: is printed on the system cone: The expected response is mm/dd/yy, where 
mm = month, dd = day, and yy = year. The entry may be preceded or followed by blanks, but may 
not contain blanks. 

8. If the real time clock (RT) has been configured into the system, the message ENTER TIME: will print 
on the system console. Warmstart expects a four character response of hhmm (where hh = hour and mm 


= minute). The entry may be preceded or followed by blanks, but may not contain blanks. 


Table 9-2. Valid Device Mnemonics 
DESCRIPTION 
Cassette Tape 


Disk Communication! 
Mini Disk 


Disk Cartridge 
Console Keyboard 


Line Printer 

Magnetic Tape 

80-Column Card Reader/Printer/Punch 
Real-Time Clock and Event Timer 
80-Column Card Reader 

96-Column Card Reader 

Serial Printer 


1 The only valid device numbers are O or 1 for this mnemonic. 


Warm start also contains the following stand-alone functions: 
a. IN (INITIALIZE) 
DISK CARTRIDGES MAY BE INITIALIZED BY ENTERING “IN” FOR THE HARDWARE CON- 
FIGURATION DURING A WARMSTART. WARMSTART WILL PRINT: 
INIT 
ENTER DATE (MMDDYY): 
ENTER THE 6-DIGIT DATE AND WARMSTART WILL PRINT: 

ENTER DRIVE NO (A-H): | | 
ENTER THE DISK DRIVE NUMBER AND INITIALIZING WILL COMMENCE. AFTER THE EN- — 
TIRE CARTRIDGE IS INITIALIZED THEN THE FOLLOWING WILL PRINT: 

ENTER NO OF TRACKS FOR DIR (1-9): 

AFTER THE ENTRY THEN THE FOLLOWING WILL PRINT: 

ENTER SERIAL NUM 
ENTER THE SERIAL NUMBER AND THE NEXT REQUEST IS: 

ENTER PACK ID 
UP TO 7 CHARACTERS MAY BE ENTERED, THEN THE NEXT REQUEST IS: 

ENTER OWNERS ID 
UP TO 14 CHARACTERS MAY BE ENTERED. THE CMS DIRECTORY IS THEN ESTABLISHED 
ON THE DISK CARTRIDGE. WARMSTART WILL THEN ASK FOR THE HARDWARE 
CONFIGURATION. 

b. CO (COPY) 
CMS CARTRIDGES MAY BE COPIED BY ENTERING “CO” FOR THE HARDWARE 
CONFIGURATION DURING A WARMSTART. TOTALDISK MAY NOT BE COPIED BY THIS 
COPY, ONLY BY THE COPY FUNCTION IN DSKGEN. WARMSTART WILL PRINT: 
COPY: ENTER SOURCE DRIVE (A-H): 
AFTER THIS IS ENTERED THEN THE NEXT LINE IS: 
ENTER DESTINATION DRIVE (A-H): 
WHEN THIS [IS ENTERED IT WILL ASK: 

ENTER PACK ID 
FINALLY IT WILL REQUEST: 

ENTER OWNERS ID | 
WHEN THE COPY IS COMPLETED, WARMSTART WILL ASK FOR THE HARDWARE CONFIG- 
URATION. 
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c. PA (PATCH) | 

A FIRMWARE PATCH FUNCTION IS NOW AVAILABLE THROUGH WARMSTART. THIS IS 
THE ONLY TIME A PATCH MAY BE ENTERED TO THE SOFTWARE. IT CAN BE USED TO UP. 
DATE ANY OPERATING SYSTEM OR INTERPRETER SEGMENT VIA THE OPERATOR CONSOLE. 

THE PATCH FUNCTION IS INVOKED BY ENTERING “PA” AS THE FIRST ENTRY OF THE 
HARDWARE CONFIGURATION. THE KEYBOARD IS ENABLED FOR THE ENTRY OF PATCHES. 
A PATCH CONSISTS OF ONE OR MORE LINES OR ENTRIES. EACH ENTRY IS TERMINATED BY 
EOM OR OCKI (NUMERIC KEYBOARD ONLY). THE PATCH FUNCTION IS TERMINATED BY 
KEYING IN “END” AT WHICH POINT WARMSTART IS RESTARTED. 


Possible error messages and reasons: 


PO! PATCH FORMAT ERROR | Number of Dwords not in 01-06 range 
| Format error detected by checking slash positions 
Correct check digit not present 
PO2 PATCH SEGMENT ERROR Segment to be patched not present in MCP file 
Patch history segment not present (should not occur) 


PO3 PATCH CODE ERROR ; Current code for the patch does not compare with actual code 
in the segment 


PO4 PATCH HISTORY NOT RECORDED Over 89 patches have been recorded so there is no more 
room in the history file. The patch has still been made on 
disk, but not recorded. : 


In addition to patching the appropriate segment on disk, a record of all patches is kept in a patch history 
file. 


RESTART PROCEDURE 


The restart procedure provides the means to reinstate or restore the system firmware and MCP in memory 
following any abnormal condition that may have affected the integrity of the system in memory, and also after 
the system is powered on. Restart reinitiates the system as it had been configured by the most recent warm 
start. | 


RESTART OPERATING INSTRUCTIONS 


Perform the following procedure to restart the system: 


NOTE 
Refer to warm start error handling for any errors which may occur. 


. Warm start will print the messages WARMSTART and HARDWARE CONFIGURATION. 
. Enter END on the operator console to request the hardware configuration by the most recent warm start. 
. A successful restart places the system in a system idle state. 


NOTE 
The dump file, DMFILOO, will remain in the Same state as the most recent warm 
Start. 


G2 NI — 


4. ENTER DATE: will be printed on the system console. The expected response is mm/dd/yy where mm 
= month, dd = day, and yy = year. The entry may be preceded or followed by blanks, but May not con- 
tain blanks. | | | 

5. If the real-time clock (RT) has been configured into the system, the message ENTER TIME: will print 
on the system console. start expects a four-character response of hhmm (where hh = hour and mm = 
minute). The entry may be preceded or followed by, but may not contain blanks. 


CLEAR START PROCEDURE 


Clear Start will be invoked by the MCP when a condition demands the abrupt termination of all tasks active 
in the system. The may normally invoke Clear Start by pressing the processor clear button. However, this should 
be avoided, if at all possible, during a probable disk access. In the process of the Clear Start the MCP will: 

1. Create a copy of system memory in the system dump file, DMFILOQ, if it exists. (Refer to warmstart proce- 

dure). Regardless of the existence of DMFILOO, if a memory parity error is the termination cause, no 
dump of system memory is performed. 
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2. Display to the operator console: 
a. A termination cause. 
b. A set of MCP registers. current mix No. and current slice. 
c. The contents of the processor registers MIR, BMAR, and MPCR. 
3. Request the operator to input the date and time (if a clock was identified in warm start). 


4. Re-establish the system integrity (for example, load system firmware from disk,disk directories are 
validated . . .) 


5. Display the MCP banner and enter system idle. 


MCP invoked Clear Starts are of three classes: Central processing Unit failures, virtual memory failures, MCP 
failures. The CPU failures result in the following termination messages: 


MEMORY ERROR There is a borderline error in the memory. The field engineer should be alerted so that he may run 
the memory test. Being borderline, it may take some time to locate. 


MPM PARITY There is a memory parity error in the location indicated by the contents of MPCR. 
DPM PARITY There is a memory parity error in the location indicated by the contents of BMAR. 
STEAL PARITY There is a memory parity error, location unknown. 


NANO PARITY There is nano parity error. The exact name can be determined by: 
1. Execute the “HEX” option of SYSDUMP. 

2. Locate the contents of the word indicated by MPCR. 

3. The lower 10 bits indicate address of the nano with bad parity. 


Virtual memory failures may be distinguished by the following messages: 
VIRTUAL MEMORY: INSUFFICIENT LOCK SPACE 


The memory required for the system firmware and the resident code and data segments of all the active tasks 
is greater than the physical memory of the system. 
VIRTUAL MEMORY: INSUFFICIENT OVERLAY SPACE 


Given this set of tasks the unused memory in the system is less than the memory required by a user’s overlay- 
able code or data segment. 


VIRTUAL MEMORY: PERMANENT ERROR 


The virtual memory routines have encountered a disk error in the process of accessing disk for a segment 
overlay. An additional display is made to aid in the resolution of the error: 
VMIO DESCRIPTOR + XO X1 X2... . X23 


Xn are hexadecimal digits. The fields within this string which may be of use to the operator are: 
X3: = Read, 1 = Write 3 = Write with Read After Write. 
4 = Firmware read. 6 = Directory search 
XS: Type of error. 
O01 = Parity 
0010 = Timeout/seek 
GOl1 Address 
X6,X7: Lower eight bits of hardware DDP Status 
X12...X15: Disk Address in hexadecimal 
X16...X19: Length in 16 bit words 


| 
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Termination messages which will usually indicate MCP failures are: 


** NANO ADDRESS#* | This refers to a nano address error and may occur due to a bad B 700MCP file on the system 
cartridge, a bad read from disk, or an MCP failure. At the very least system support wil! require a 


HEX version of SYSDUMP; the formatted dump would also be helpful. 


This error is provided for but due to the minimum memory requirements of a B 776 user it will 
never occur. 


** MPM ADDRESS 
ERROR ¥# 


** DPM ADDRESS 
READ *« 

** DPM ADDRESS 
WRITE «xx 


** STEAL ADDRESS 
READ 


The contents of BMAR can be used to confirm the eorrectness of either of these errors. The 
discussion of reasons and steps to take outlined in NPM ADDRESS ERROR also apply for these 
| two messages. 


This indicates a direct memory access device, that is, DCP or disk, has accessed a word beyond the 
memory limits. At the very least, system support will need a formatted version of SYSDUMP for 
either of these errors. : 


** 0S TASK HAD BAD 


This message will have been preceeded by a message with the event number 70, 71, 72, or 73. 
DATA #* - 


This normally implies an MCP failure and a formatted dump should be taken. 


Examples of CLEAR/START printouts follow: 
a. CLEAR/START 
** DPM PARITY ERROR#*# 
DMFILOO NOT CREATED 
CURRENT MIX NO. = 0001 
CURRENT SLICE = 001B 


MIR = 0005 
BMAR = 2D67 
MPCR = 0130 


ENTER DATE: 11/21/75 
ENTER TIME: 1045 
MCP2. 0 R ########HAHHHH 75326 


This indicates a memory parity error at location 2D67 while task 1 was executing. As indicated earlier, 
memory parity errors do not create a DMFILOO. 
b. CLEAR/START 
DMFILO0 CREATED 
CURRENT MIX NO. = 0010 
CURRENT SLICE = 0020 


MIR = 0000 
BMAR = BE2C 
MPCR = 0000 


ENTER DATE: 11/21/75 
ENTER TIME: 1110 | 
MCP 2.0 R ######H##HHHHHH 75326 


Since both MIR and MPCR = 0000 this indicates that the operator probably pressed the clear button on the 
processor control panel. 


NOTE | 
It is strongly recommended that the clear button not be pressed when the system 
has active tasks since in process disk write operations may be corrupted. 


c. CLEAR/START 
DMFILOO0 CREATED 
CURRENT MIX NO. = 0S TASK 000E 
CURRENT SLICE = 0040 


MIR = 4C09 
BMAR = BDE4 
MPCR = 0000 


ENTER DATE: 11/21/75 
ENTER TIME: 1200 
MCP 2.0 R #####H#HHHHHHHH 75326 
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Since MPCR = 0000, this cannot be a hardware trap to location 0. Since MIR = 0000 this cannot be a result 
of the clear button. The conclusion is that there has been an MCP failure. The operator should take a HEX 
version of SYSDUMP. . 

d. CLEAR/START 

'** DPM ADDRESS READ #*¢# 
DMFILOO CREATED 
CURRENT MIX NO. = 0001 
CURRENT SLICE = 0022 


MIR = 20630. 
BMAR = F3B5 
MPCR = 0131 


ENTER DATE: 11/21/75 
ENTER TIME: 1231 
MCP 2.0 R ##H####HHHHHHH#H 75326 


BMAR is certainly out of range, therefore, it is likely to be an MCP failure. Take a HEX dump. 
e. CLEAR/START 

VIRTUAL MEMORY: PERMANENT ERROR 

DMFILOO CREATED 

CURRENT MIX NO. = 0001 

CURRENT SLICE = 002C 

VM10 DESCRIPTOR = 0000014028000272005 A2234 

ENTER DATE: 11/21/75 

ENTER TIME: 1335 

MCP 2.0 R ####HHHHHAHAHH 75326 


This indicates that Virtual Memory has encountered a parity error while reading sector -0272-. X5 indicates 
a parity error for software. 


SYSTEM DUMP ANALYZER (SYSDUMP) 


The System Dump Analyzer is a debugging aid for the programmer. In order to operate SYSDUMP the sys- 
tem dump file DMFILOO must be present on the system disk. Space is reserved for it at warm start time if 
the operator responds yes (“Y’’) to DUMP FILE?. Any system dump file which was previously on disk is re- 
moved. During restart the system dump file previously on disk is left unharmed. The dump file is created during 
the system clear start routine which may be initiated by (1) the operating system when it detects a fatal error, 
or (2) by the operator who may initiate a hard clear by pushing the Clear button on the processor. SYSDUMP 
examines this file and arranges it into an easily readable format. 


While the system is operating, the command to execute the dump is given via the system console. If an unfor- 
matted dump is desired, HEX is entered with the execute command. 


After a formatted dump, SYSDUMP will go to EOJ. After an unformatted dump, the program will display 
the message FORMATTED DUMP?. If a formatted dump is desired, the alphabetic character Y is entered via 
an AX command. SYSDUMP will terminate automatically after the formatted dump. If a formatted dump is 
not desired, the alphabetic character N is entered via the AX command. The character N, in response to FOR- 
MATTED DUMP?, causes SYSDUMP to go to EOJ. 


OPERATING INSTRUCTIONS 


The System Dump Utility may be executed at any time the system is operating by entering via the operator 
console: 
SYSDUMP HEX 


HEX is an option that, if entered, will produce an unformatted memory dump. Default is a formatted dump. 
After an unformatted dump, the program will display: 
FORMATTED DUMP? 


A yes (Y) or no (N) answer is expected. After a formatted dump, the program will go to end-of-job (EOJ). 


If, during the execution of the formatted dump, the program detects a virtual memory address error (due 
usually to the timing of the creation of DMFILOO), the formatted dump will be discontinued .and replaced by 
an unformatted dump and the message: . | 

PROCEEDING WITH UNFORMATTED DUMP 
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Table 9-3. Warm Start Error Messages 


W00 BAD MCP FILE The contents of the B 700MCP file are corrupt and as such are unusable 


by warmstart. 


W01l PORT ALREADY 
WARMSTARTED 


W02 INVALID PORT 
W03 PORT NOT ON 1 TO 12 


W04 DEVICE ALREADY 
WARMSTARTED 


W05 INVALID MNEMONIC. 

W06 INVALID DISK PORT 

W07 DISK NOT WARMSTARTED 
W0s TWO DISK ENTRIES 


Two different devices warmstarted to one port. 


Invalid Port number. 


Port number greater than 12. 


Two entries of the same device with the same device number. 


The mnemonic is not one specified in Table 9-2. 
The port number for the disk entry is not 4. 
Disk not entered when warmstarting. | 


The disk has been specified twice during the input of the hardware 
configuration. 


W09 DISK DEVICE NOT A TOH 
W10 DC NOT ON 0 OR 1 
W11 TOO MANY ENTRIES 


W12 DISK NEVER WARMSTARTED 


Disk Device number not in the range of A to H. 
Data Communications not an 0 or 1 for device number. 
More than 40 characters entered. 


A restart has been attempted before this disk has ever been 
warmstarted. 


No DDP number entered. 


No device number entered. 


W13 NO DDP 
W14 NO DEVICE 


W15 DUMP FILE SIZE TOO SMALL In the process of a restart, the size allocated to the DMFILOO is less 


than that required for the size of memory. 


W16 INVALID 


TROUBLE X1X2 X3X4X5X6 
X7X8X9X10 


An invalid date or time entry has been made. 


Where X1 thru X10 are hexadecimal digits the trouble message will 
occur when warmstart has ‘detected a hardware fatal error. XSX4X5X6 
will be the contents of processor MPCR register at the time the error 
occurred. X7X8X9X10 will be the address contained in the processor 
register BMAR. X1X2 is the error code and may be decoded as follows. 
(Refer to Clear Start procedure for additional details). 


80 MEMORY ERROR 
84 NANO PARITY 
85 NANO ADDRESS 
86 MPM PARITY 

87 MPM ADDRESS 
89 DPM ADDRESS WRITE 
8A DPM PARITY 

8B DPM ADDRESS READ 
8D STEAL ADDRESS WRITE 
8E STEAL PARITY 

| 8F STEAL ADDRESS READ 
HELP XX X 


X is a hexadecimal digit. If XXE00, a failure has occurred when trying to read or write to the disk. The B 700MCP 
file cannot be found. 
The eight binary bits in hexadecimal digits xx are numbered as: 76543210 
Bit Setting: | 
1 = Write Inhibit set. 
= Seek on the drive not working. 
= Illegal address error. 
File not operational. 
Seek incomplete. 
Parity Error. 
Time Error (Operation Timed Out). 


low ued 


~2 DO be CO DO 
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SYSDUMP ERROR MESSAGES 


CANNOT OPEN FILE - SYSDUMP TERMINATING 
The operating system detected an error, such as file not present, while trying to open DMFILOO. 

DMFILOO0 BAD DUMP FILE OR HAS NOT BEEN CREATED 
The flag which specifies that DMFILOO has been created is not set. 

CANNOT OPEN FILE B 700MCP - SYSDUMP PROCEEDING WITH UNFORMATTED DUMP 
The operating system has detected an error while trying to open the driver*file. An unformatted dump will 
be produced. | 

ERROR DETECTED - FILE B 700MCP 
A disk error has been detected during a read of the file B 700MCP. If an unformatted dump has already 
been created during this run of the program, SYSDUMP will terminate. Otherwise an unformatted dump 
will be produced. 

ERROR DETECTED - DUMP DRIVER 
A disk error has been detected during a read from the driver file. Unless already created, an unformatted 
dump will be produced. 

EOF DETECTED DUMP DRIVER 2 | 
End of file has been detected during an attempted read of the dump driver. Unless already created, an 
unformatted dump will be produced. 

ERROR DETECTED - DMFILOO 
A disk error has been detected during a read from DMFILO00. SYSDUMP will immediately terminate. 

EOF DETECTED - DMFILO00 
End of file has been detected during an attempted read of DMFIL00. SYSDUMP will immediately termin- 
ate. 

PROCEEDING WITH UNFORMATTED DUMP 
SYSDUMP has detected a bad operator in the driver table and is unable to complete the formatted dump. 


EXPLANATION: OF FORMATTED DUMPS 


This section explains and gives examples of a formatted dump analysis listing in the actual order listed. 


The following paragraphs explain the individual sections of the analysis. 


HEADING 


The format and content of the first page heading section of the printout will be as follows: 


B77 6 OPERATING SYSTEM DUMP ANALYZER 


04/29/77 00:00:00 


ANALYZER VERSION: 1.0¢10/01/76) 
OPERATING SYSTEM VERSION: 02/28 


DUMP FILE CREATION DATE: 04/29/77 


PATCH HISTORY 


The program lists the patch number and segment number of each patch made to the MCP or Data Comm 
Firmware files. This section of the printout will be as follows: 


PATCH HISTORY 


PATCH NO SEG NO 


0001 QO4F 
0001 OO4F 


0002 0020 
0002 0003 
0003 0065 
0003 0003 
0003 0003 
C006 0014 
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HARDWARE REGISTERS 


This section of the printout will be as follows: 


PAGE GBMAR MPCR ERROR 
0000 8n49 OO0ON 0N90 


The hardware registers are identified as follows: 


Memory Information: Register. 
Memory Address Register. 
Micro Program Count Register. 

Hardware Error Code from the External Bus. 


OPERATING SYSTEM REGISTERS 


This section of the printout will be as follows: 


0S A CURRENT PTRS / . LOCKS / TASK/ WSB ERROR 
FLAGS MAT TID SLICE MAD VM SCL O/C E0J TIMER FLAGS COUNT 
0080 0000 68049 0000 00460 0140 FFFF FFFF FFFF FFFF 8000 0000 0000 


/ EXTENTS 4 LAST VM HOLE SLICE SDT 
BvM PSEUDU MECRO SLICE 0C TVM ALLOC OBJECT SIZE FLAGS BASE 
166 1688 102F 1664 8005 A&*sD GOOD BEIB 0370 0018 68058 


LOADER REGISTERS 
0co00 0000 0000 0000 0000 0000 0000 00G0 0000 0000 0000 0000 0000 0000 0000 0000 


Iscr ; 
- 0000 BFE2 BFCF BFO9 BFA 0000 BFC2 BFEB BFF3 0000 0000 0000 0000 


The operating system registers are identified as follows: 


OS Flags Flags for use by operating system routines. 


CURRENT PTRS | 
HAT Address of the current task’s entry in the Mix Attribute table. 
TID Task-ID of currently (at the time of creation of DMFILO0) processing task. 
SLICE Slice number of currently executing slice. 
MAD The last Micro Address Descriptor processed by the operating system. 


LOCKS 
VM 


Flags used by the operating system to protect the non-reentrant code of: 


Virtual Memory. 


SCL SCL Slice. 

O/C Open/Close. 

SPO SPO or operator console. 
A/D Allocate/Deallocate. 


DMAC-ERR COUNT 
BVM 3 

EXTENTS 
PSEUDO 


Register used internally to the DMAC-Disk Controller to count retries on a particular Disk I/O. 
Address of Beginning of Virtual Memory. 


Address of the first D-word after pseudo-nucleus. 


MICRO Address of the first D-word after micro slice area. 

SLICE Address of the first D-word after slice area. 

DC Address of the first D-word of data comm area. 
TVM | Total number of bytes of Virtual Memory. 
LAST ALLOC Address of end of last allocated segment in overlayable area. 
VM OBJECT Address of object descriptor (slice or segment). 


HOLE SIZE Size of hole required for VM access. 

HOLE ADDR Address of hole required for VM access. 

SLICE FLAGS Flags used by the operating system for VM access. 
SDT BASE Address of base of SDT. | 


LOADER REGISTERS Workspace reserved exclusively for the loader. 
ISCT | 


MIX ATTRIBUTES 


Base address of Interrupt Scan Control Table. 
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Lists each currently scheduled task by mix number, gives the current state of the task (runnable, short waited, 
suspended — swappable, suspended -— swapped out) and its wait key. If the task is not marked runnable, this 
column provides the reason for the suspension. This section of the printout will be as follows: 


16 SHORT WAITED HELP TASK NOT IN USE 


16 SHORT WAITED OC © SUSPENDED 
12 SHORT WAITEO OC SPACE HANOLER IDLE 


VIRTUAL MEMORY LINKS 


This section of the dump verifies the virtual memory links in each of the four areas of memory: pseudo-nu- 
cleus area, micro slice area, TCB/PCB slice area, and the overlayable area. It analyzes the usage of the overlay- 


able area by listing each data segment and available area by length (in D-words). This section of the printout 
will be as follows: 


ANALYZE MEMORY LINKS 
PSEUUO NUCLEUS AREA LINKS OK 


MICRN SLICE AREA LINKS OK 
TCB/PCS SLICE AREA LINKS OK 
AVAILABLE 3 0642 
SEGYENT : 00466 
AVAILABLE 3 9834 
OVERLAYVABLE AREA LINKS OK 


VM LINKS OK 


PERIPHERAL ASSIGNMENTS AND DESCRIPTORS 


This section of the printout will be as follows: 


PERIPHERAL ASSIGNMENTS AND DESCRIPTORS 


PORT # 006 | 
OKA POWER OFF 
PACK=10 = 
¢$ OPEN FILE n0000 
DIRECTURY INFORMATION = 0000 0000 0C00 0000 9090 0000 
1/0 DESCRIPTORS: 
NONE 
OKB SYSTEM RDY 
PACK-10 = CmMS6800 
8 OPEN FILE 99060 
OIPECTURY INFORMATION = 0020 0004 002% 0008 902F 0D/1 
170 NESCRIPTORSS 
NONE 


PORT 8 C06 
MTA NOT ROY 
MFIO/FIOD = UNLABELLED 
ASSIGNED TO TASK UNASSIGNED 
REEL 8 . 
1/0 DESCRIPTORS: 
NONE | 


PORT 8s O02 
- LPA NOT ROY 
MFIO/FIO = UNLABELLED 
ASSIGNED TO TASK UNASSIGNED 
1/0 OESCRIPTIRS: . 
NONE 


PORT # 003 | 
RBA NOT ROY 
MFIO/FIO = UNLABELLED 
ASSIGNED TO TASK UNASSIGNED 
1/0 OESCRIPTIRS: 
: NONE 


PORT s O01 
oco 


PORT 8 007 
RTC 


PoRt ¢ 008 
SPO ROY 
T40 OESCRIPTORS: 
NONE 
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Lists each warmstarted device by port number and then lists: 


Device Mnemonic Code name characterizing a certain device. 

Current Status RDY, NOT RDY, Power Off. 

PACK-ID File name assigned to device (disk only). | 

MFIL/FID File name assigned to device (card readers, tape units, printers only). 

ASSIGNED TO TASK Mix number of task to which device is currently assigned. For card readers, tape units, printers only. 
OPEN FILE The number of files currently in use on a particular disk. , 

REEL | The number assigned to each tape unit; used for multi-reel files. | 

DIRECTORY Directory information block - disk only - 12 byte block consisting of 6 fields: 

INFORMATION , | 
(1)non-file directory disk address. 
(2)length of non-file directory (sectors). 
(3)file directory disk address. 

(4)length of file directory (sectors). 

(5)disk file header disk address. 

(6)length of disk file header list (sectors). 
I/O DESCRIPTORS I/O descriptors currently in device’s queue. 


TASK DETAIL TABLE 


This section of SYSDUMP consists of one entry per task and contains task history information. 


This area of the printout will be as follows: 


TASK OETAIL TABLE -- DISK COPY . 
C9300 6000 0000 0009 0000 0000 0000 OCCO 0000 0000 0000 0000 0000 oDDD 0000 0000 0000 0000 0000 0000 0000 o900 
0015 0900 9900 0909 0030 0000 0000 O0CO OCOC 0000 0000 0009 0000 0009 0000 0000 vo0N OD00 oD00 0000 0090C vOvD 
COZA 0000 0000 0099 C000 0000 0000 G0CO 0000 0000 0C00 0000 nO000 0090 0000 0000 0c00 ooLD 0000 0000 90000 OCZA 
OO3F ‘C099 CO90 CO00 COI0 0000 0000 OOCN A0NC NOUN 00ND OOOO DODR 0000 0000 0000 0000 0000 OCO0 0000 nan anno 


6154 N00 6COO ONNA £690 GANA ONNN OLCD OONG VOANO OOH GODDO OVOO VOLVN A000 OVvUD 9900 0000 OCO0 OLOO ON00 OC00 
006? CNV00 CAGN ONDA 0090 0NHN NANDA ANGA NOAN NNNA ANNA NANN ANNA ONAN NNNA DNOD 0000 0000 V000 OHVO VOUE VOUU 
QUEL COU0 GOOG UYIU GUNG COLO OOUG LCCO ULUC OUU0 0000 0000 0000 0000 0000 ODN0D0 OGDN 0090 0000 00nd GNNO OnN0N 


0193 2090 000C 0000 0000 CNNO O0V0 OLLO 0000 O0UU ONUO 0N00 0000 0000 VOVO 0000 0000 GODD0 CDDD 0000 0000 0000 
0JA8 occd 0009 0000 CONN 0000 9090 NCCO 0009 O0ND ON00 0000 0000 NLOO ONNDO NONY NOD0 CODD 0000 COU0 C000 L000 
0080 6900 OC00 C900 0030 0000 0000 00fO 0900 00NN OLNN 00ND ONCO ON00 GOAN ONAN ONNN ANDA OGNO OnON 9990 0000 
NND2 0000 0090 GNN0 GL00 YVOVO 0090 LUCY VOU 00UON OUVOL 0000 VOD VOLVO 0000 0900 0000 0000 O000 o000 an00 0060 
00€7 C000 GCOO 0090 C090 C000. 0000 ONCD 009CG ONNM OCOO 0000 ON00 DOVO COVO ONDD0 0000 GOO00 0000 0000 0000 0000 


SOT 

0050 0009 0009 CD70 0000 O5N0 0NNO OOCO GO9OU 09ND 00N0 0000 O0CO O0V0 ON0O 0000 ONVO 0000 D000 oODD 00G0 
0014 0000 0000 0009 0190 GAD0 NN0O OCCO 0005 0000 0000 0000 0000 0000 OnDD 0000 0000 CODD oDDD 0000 OCc00 
0028 0000 0909 00090 0000 0000 0900 00CO 0000 0009 0009 0900 0000 9000 0000 ODNO 4200 ONND 0076 NNOD 0000 
NN3C C290 0090 O3CC 1076 0001 C2N0 COUGH 0029 1030 0001 C200 OVOO UNID 105A DUO! 4200 VODO OO2ZE OQVO “CNnD0 
650 AC10 0479 N9S% O6CA 60ND 281G OOCN 0000 ON0N O0ND 2510 0000 ODDU GYUU DONO aci10 O4AF DOES2 101F 6000 
0364 2419 0247 OVAF COI0 0090 2810 G26s O23 0N00 D000 2810 0275 0158 CUOU 0000 2810 0251 0258 COCO O0C00 
0973 2610 O25€ OOFE 0490 GNCO 281G 020) 0238 NOD0 NOOO 2810 A309 O2rsH D000 UNDO 2810 A27N D244 ANNO goo0 
ONAC 24810 G22 0332 CAND 0090 2810 GUCO H000 UOOU VUUU 2810 Uo/1 1139 OUOO ON0D 2810 0144 0265 O000 OO0N0 
O)a9 2410 0178 029C CNI0 CO00 2816 1399 0289 NNON NOOO 2810 0381 016C 0000 0000 2810 O16D 01C0 0000 0000 
ONES E8190 O1B2 6075 1894 O01 a810 0185 0125 1COA UO0I 2810 0192 O2FB COND ONN0 2810 0184 O267 C000 0000 
09C8 2410 O3FO 0273 0099 ONN0 2810 0654 O05SF 0900 0000 2810 0430 0209 0000 0000 2810 O441 O2NcC 0000 OcOG 
QUOC 2610 0452 U27N 0930 ONUY 28610 0461 O286F 0000 0000 2810 0470 0131 0000 0000 2810 OND DONO OnOO 0000 
OOFO 2810 OVBE O18C 0990 ONVO 2810 01C6 0098 YOON OU0U 2810 O1L2 0148 OOOO OVOU 2810 OIEC O14E 0000 OC00 
0104 2810 O1F 4 GIES COI0 0000 2810 O2C0 024c 20A0 0090 2810 01CA 0419 CODD ONDD 8810 0192 0108 1A88 0091 
0118 B439 0159 OSE 1449 0001 281C 0613 O37F NNNN OUNON 2810 0628 031K CCON ONND 2410 083A G0O0B 0000 O00C 
O1¢C 2819 S638 054% 0090 CUNC 2810 UbC2 0599 ON00 OCUND 2810 9668 0068 D000 NON0 2810 05909 Q1€c¢ OOOO 0000 
014) 24810 6593 O36F 1030 COON 2461C 0527 02C8 00ND OCOO 2816 0591 O37F CUOO DODO 2810 0332 0083 C0009 0000 
015% 23810 0427 0176 OCDO0 COUD 2810 045F 020A 0N00 OG00 2810 0517 019% D000 OVOO 2810 0213 OORA 0000 ocod 
01438 2610 0227 0397 0900 0000 2810 0650 O0A1 0000 O000 2810 0657 0141 DODU O00 2810 O5F5 018¢ 0000 0000 
G17C 2619 OSFO O15C 0070 0000 2810 O5F8 0187 0000 0000 2810 023C 01€5 0000 00ND 2810 O3RB4 0A586 Q000 9000 


0199 2610 0164 0591 ONN0 GUND 2810 O66E 0053 NNO 0000 2810 02868 O2ED OUVOU 0000 2810 029C 0302 OD00 0090 
O1A4 2810 0205 0416 0030 0000 2810 O2EA 02A3 ONND NOOO 2810 O2FA 0297 0000 0000 2810 0318 O2AE 0000 0000 
0168 2610 0328 0120 0000 0900 2810 O3FF 0169 ON0N OGO0 2810 O40A O1FE OCNO O00 2810 0348 0205 0000 0090 

— O1cCc 2810 G38A 0249 CCOO 0000 2810 014C 0236 ONNDO OGOU 2810 0336 0298 0000 0000 2810 0346 020K 0000 oDDD 
01€9 2810 C352 6271 COI0 CONC 2810 0361 0252 0300 OCOO 2810 O36F 0300 0000 0000 3816 O05C8 O2Nc CD00 0cO00 
C1F 4 ACI1O OOC9 0186 0543 6900 3810 O5A6 05C8 0000 0000 2810 059C 0185 0N00 OC00 3810 0117 0358 0020 oD0C 
C208 3810 O10€ CO35 0000 0900 3810 0109 OOCC ONDN 0000 3810 00R9 0543 0000 00N0 0000 0000 0000 000 ocoa 
N21¢ 9009 O6N0 6000 0000 ONUU OOUU OUCU GUUU VU0D0 LULU 0000 0000 0000 0000 0000 0000 0000 0000 0000 oa0D 
0230 0CGO OCO0 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 00020 0000 
0246 CcO9 OGOC 6009 C000 0090 0000 UOCO 000C 0000 OcCoO 
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PRINT TCB 


_ This section of SYSDUMP prints out the contents of the Task Control Block (TCB) of five independent run- 
ners and eleven possible user mix numbers. The user task numbers are 1 through 11. The independent runners 
are the SCL-Loader, the help task, the working set bailiff, the result queue processor, and the data comm space 
handler (Task 12). This area of the printout will be as follows: 


SEGMENT 051 | 
SEGMENT NOT PRESENT 


SEGMENT O32 
SEGMENT NOT PRESENT 


HELP TASK TCB 
TCB 


POINTERS 
0000 0000 1030 1045 1047 1058 0000 OCCO OCO0 1030 0000 0000 0000 


CPA 
0°00 0000 1030 1045 1047 1058 0000 0000 ONnO0D 


OST 
0900 0010 0000 0037 0000 0510 0000 OOSA 21FE 


STACK 
TOS (9 RELATIVE): 0002 
0000 0140 6490 4018 4040 0000 0CO1 ODCO 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 


SEGMENT O00 
SEGMENT NOT PRESENT 


SEGMENT 001 
SEGMENT NOT PRESENT 


WORKING SET BAILLIF TCB 
TCB 


POINTERS 
0000 COOO 1067 1067 1068 1077 0000 0000 0000 1067 0000 0000 0000 


CPA 
0000 COOO 1067 1067 1068 1077 0000 OOCO 0000 


OST 

0009 

STACK 

TOS (O RELATIVE): 0001 

0009 8a79 0000 0000 O0CO00 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 


RESULT QUEVE PROCESSOR 
TASK NOT PRESENT 


WORK REGISTERS : . 

0000 856C O8B8 2184 FFFF FFFF FFFF FFEF FFFF 0000 BD049 O00D 1030 0040 0140 BD46 18598 
0910 1888 102F 1644 BDOS BDOS C000 A4&4D B05B BFAD BF72 0068 0002 0000 C000 BE9B 0370 
0020 1D2F 0078 OOOC FC9D 0370 2401 2487 0049 0017 4018 FFFF 1804 0000 2810 0200 O24Cc 
0030 2070 SFAI 0100 8000 0000 0440 BOCS OVEA SFFF OOFE 0014 FFFF 0005 BFAY 0100 BFF3 


0049 OOOO BFEB BN4&F OOOO OOVO BFAY 0100 BD37 0080 0000 0000 0000 0000 0000 0000 0000 
0050 occeod 0000 0000 0000 00U0 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 BD05 
0060 0000 0000 0000 0000 C000 00090 O0CO 0000 0000 0000 0000 0000 C000 0000 0000 00CcOd 
0c070 0000 O0U0 CO00 0090 0000 0000 0000 0000 0000 2494 2h1F 4448 BFCF BFD9 BFAY ONTO 
0080 BFC2 BFEB 0000 R049 CO00 0000 0000 25N0 0076 229€ 2256 BFF3 42FA 0057 OOO2 283E 
0099 BUCS UCOO 0609 8048 0900 0000 O00CDO 0000 0000 A000 0000 OVND OLOO OC0N 0N0CD 0000 
OOAd coco 9000 6900 CCOO CO00 BFR3 4229 0022 0000 0000 0000 0000 0009 GO00 O0N0CO aNn00 
098) bvooud OVeO 0000 0090 00900 0900 000cN O0C0 0000 OCND 0000 0000 0000 O00O0 H000 0000 
00CcO 000) 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 9000 
Ovv0 0060 0000 0690 C090 CO00 000C OOCO O00E 0000 0090 0000 0000 OCL0 0000 00ND 0000 
O0£O 0000 0000 0000 0000 0000 0000 00CO O000C ONGO 0000 OC00 0000 0000 0000 On00 0000 
OoFO 0000 co0d0 on0N HO000 0000 0000 O0CO 00NO 0000 0000 0000 0000 0000 0000 0000 0000 
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If a task is present, the Task Control Block is broken out as follows: 


Pointers 7 The first 12 entries of the TCB: 


PSN/ISN The entry numbers in the SDT of the Program Control Block and the Interpreter. 

DST Base Absolute address of base of Data Segment Table. 

DST Limit Address of the first word after DST. 

TOS Address of the next available entry of data stack. | 

Stack Limit Address of first word after stack. | 

MCH TOS Recover The difference between the present TOS and the base of the TCB. Use for error recovery in the 
Master Communicate Handler. , 

MCH Active Verb Relative address of the CPA from the base of the TCB. 

TCB Flags Flags used by the operating system to interface between system modules. 

MRA Base Address of base of Message Reference Area (used by data comm tasks). 

COMM Result A Result of an I/O communicate returned by some OS module. 

COMM Result B | 

S-Start PCA Program Count Address. The Interpreter’s offset into the current program segment. 


IPA The Interpreter Preset Area is a work area where the S-Interpreter will store relative addresses 
before relinguishing control to the operating system. 


CPA The Communicate Parameter Area contains all the parameters and variables required for a particular 
communicate S-Operation. 


DST | Data Segment Descriptors listed in the order of increasing segment number. 
Stack Area in TCB used by the OS for control and storage of parameters, data, relative returns, etc. 


Data Segments Each data segment which is currently present in memory listed in order of increasing segment 
number. A data segment which is an FIB is listed as such and if it is open SYSDUMP also lists 
certain pertinent information from its FIB. 


PRINT SLICES 


This section of the dump prints the disk open and close slices, the allocate, deallocate slice and the reconstruc- 
tor slice if they are present in memory. 


DATA COMM AREA ANALYSIS (ONLY IF RELEVENT) 


Registers 


DC LOCK Contains the lockout-ID of the processor which is currently in control of the queue of available 
buffers. 


BUFFER SIZE Contains the text capacity of a 
DC buffer. It equals the DC 
buffer size minus two specified in one’s complement form. 


LOGICAL LISTS 


LINE 
STATION 
TERMINAL ADDRESS 


SUBNET Q TABLE 
DC XREGS 


AVAILABLE BUFFER 
POOL 

HEAD 

TAIL 

COUNT 


STATUS 


RESERVE BUFFER POOL 


HEAD 
TAIL 
COUNT 
LIMIT 


XTENT 
BASE 
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Address of list of line table addresses. 
Address of list of station table addresses. 
Address of list of terminal table addresses. 


Address of the subnet queue table or all ones if no files were declared in the NDL program. 
Address of the base of the table known as “DC Extended Registers”. 


The address of the first buffer in the queue of available buffers. 

The address of the final buffer in the queue of available buffers. 

The number of data comm buffers which are currently available for use. Any buffer that is currently 
being used as part of a message is not counted. 

Contains run time information as to whether or not a particular task is being waited because of a 
deficiency of available buffers. 


The address of the first buffer being held in the reserve pool. 

The address of the final buffer being held in the reserve pool. 

The number of buffers currently being held in the reserve pool. 

The number of buffers needed in the reserve pool before the space can be released to the operating 
system. 

The highest address that can be written a DC buffer in the reserve area. 

The lowest address that can be within a DC buffer in the reserve area. 


PMLC 0 


REQUEST 
HEAD The address of the next message to be processed by PMLC-0. 
TAIL The address of the final message that is currently waiting to be processed by PMLC-O. 
~ RESULT 
HEAD The address of the next message that has been processed by the PMLC-O firmware but has not yet 
been handled by the PMLC interrupt processor. 
TAIL The address of the final message that has been processed by the PMLC-O firmware but has not yet 


been handled by the PMLC interrupt processor. 
PMLC 1 


REQUEST 
HEAD See PMLC 0 REQUEST, HEAD. 
TAIL See PMLC 0 REQUEST, TAIL. 
RESULT 
HEAD See PMLC 0 RESULT, HEAD. 
TAIL See PMLC 0 RESULT, TAIL. 


DC EXTENDED REGS 


Contains implementation dependent DC registers and pointers that are not appropriate in any of the NDL 
tables. 


LINE TABLES 

Contains information about the line as described in the NDL program. 
STATION TABLES 

Contains information about the station as described in the NDL program. 
TERMINAL TABLES 


Contains information about the terminal as described in the NDL program. 
SUBNET QUEUE TABLE 


Contains implementation dependent registers and points for each subnet queue (file) defined in the NDL pro- 
gram. | 


PMLC 0 Request Buffers Contains pointers to messages that have not been processed by PMLC 0. 
PMLC 0 Result Buffers Contains pointers to messages that have been processed by PMLC 0 and are being forwarded to the 
data comm module for further processing. 


PMLC 1 Request Buffers See PMLC 0 Request Buffers. 
PMLC 1 Result Buffers See PMLC 0 Result Buffers. 


AVAILABLE BUFFER POOL 


Contains pointers to DC buffers that are not currently in use. 


RESERVE BUFFER POOL 


Contains pointers to DC buffers that are not currently in use and reside in an area that is about to be returned 
to the OS overlayable data area. 


DC STATE SPACE 


Contains all of the data comm tables and buffers that reside in main memory as well as the NDL S-OPs. 


MPLII DUMP ANALYZER (MPL2DUMP) 


The MPLIT Dump Analyzer is a debugging aid for the programmer. When an MPL program is DP-ed, a dump 
file is created on disk. MPL2DUMP examines this file and arranges it into an easily readable format. 
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OPERATING INSTRUCTIONS 


~MPL2DUMP may be executed any time the system is operating by entering via the system console: 
MPL2DUMP filename HEX 
“filename” is the name of the dump file created when the MPL program was DP’ed. It will reside on the same 
disk as the object code file. 


HEX is an option that, if entered, will preduce an unformatted dump. peau is a formatted dump. 
ERROR MESSAGES 


If an error is detected in the execute command, MPL2DUMP will display the message: 


*** INVALID UTILITY PARAMETER ### 


Check the execute statement just entered as described in the procedure below: 

|. Check that the file-id of the dump file was entered. If it was not entered, re- enter the execute statement 
and be sure to include the file-id. 

2. If the file-id was entered, count the number of characters in the file-id. There should be 12 characters 
or less. If the file-id was greater than 12 characters, re-enter the execute statement using the correct file- 
id. 

3. If the file-id was entered correctly, check if the dump file is on the disk. If the dump file is not on the 
disk, then the disk containing the dump file must be installed in a disk drive. 

4. If the pack-id was entered, check that is does not contain more than 7 characters. If the pack-id was en- 
tered incorrectly, re-enter the execute statement with the correct pack-id. 


If an error is detected in the dump file, MPL2DUMP will display the message 


| *** ERROR DETECTED IN DUMP FILE ## 


If an unformatted dump has not been produced, MPL2DUMP will print one and terminate automatically. 


EXPLANATION OF FORMATTED DUMPS 


This section explains and gives examples of a formatted dump analysis listing in the actual order listed. 


NOTE 
Whenever both the hexadecimal nen and decimal values are given, they will ap- 
pear in the form: 


HHHH/ DDDDD 


where 
HHHH is the hex and DDDDD is the decimal equivalent. 


The following paragraphs explain the individual sections of the analysis. 


HEADING: 


The format and content of the first page heading will be as follows: 


MPL2 OUMP ANA : 629077 
PROGRAM ID. -ASBBOO/KA 


OMFILE If OOONO0O/0MF iL 11 
REASON © | (CO00} USER REQUESTED 


_ The actual data, program identification, dumpfile identification, and reason for the dump will vary accord- 


ingly. 
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S-REGISTERS 


The format and content of the S-Register section will be as follows: 


S@REGISTERS 


0003700003 
0000700000 
0133/00307 
0001/00001 
00077/00007 
O57A/01402 


0002700002 
0001700001 
0000700000 
0013700019 
0002/00002 
0000/00000 


0000/00013 
PROCESS 


Segment number of the currently active procedure. 

Procedure number of the currently active procedure. 

Address of the S-instruction currently being executed. 

Size of the literal pool for the currently active procedure. 

Number of local descriptors in the currently active procedure. 

Address of the next available byte in the data stack (segment 0). 

Address of the next available byte in the control stack. 

Mode of the MPLII Virtual Machine: PROCESS, REMAP, or DECLARE. 
The lexical (lex) level of the currently active procedure. 

The lex level of the most referenced region. 

The lex level of the next most referenced region. 

Interpreter arithmetic work register used by certain S-OPs (DIVIDE, MOD, etc). 
Number of the currently called procedure. 

Number of the next available message reference. 


DECLARE (DECL) REGISTERS 


The format and content of the Declare Registers section will be as follows: 


OECL REGISTERS 


057A/01402 0233700563 
0000/90900 0273/00627 


The following table lists the registers and identifies their contents. 


Register Name | Data Stored in Register 


Next Descriptor Address. The offset into segment 0 of the next descriptor to be declared. 

Segment number of the data currently being declared. 

Start Of Last. The offset into segment number SEGN of the start of the last descriptor’s data area. 
End Of Last. The offset into segment number SEGN of the end of the last descriptor’s data area. 
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DISPLAY 


The display section contains the lex level and corresponding offset into seomieiit 0 of the base of the descrip- © 
tors for each lex level’s most recent procedure invocation. The format and content of the display section will 
be as follows: 


OISPLAY 


LEX LEVEL DATA STACK PIR 
0900709000 
0355790353 
0550/01373 
900067,)0000 
0900700000 
ocoo/ocooo 


0000700000 
o0v0/v0000 
0000790000 
acoovo0cco 
ov0n/00000 
0000700000 
0000700000 
0000/00000 
0900700009 
ov00/00009 


MISCELLANEOUS (MISC) 


The format and content of the MISC section will be as follows: 


/ 


FETCH VALUE 000000 

OPCODE 0073 

TEMPS 0992 0383 0003 O3FC 3631 FFFF OO02 OOCA FFON 13F8 20CE 2710 
CPA 8402 1010 0010 GO0O0 C000 0000 0000 0000 


MISCELLANEOUS (MISC) (Continued) 


The table below lists the miscellaneous registers and identifies their contents. 


FETCH VALUE | Last communicate response. 

OPCODE The opcode of the current instruction. 

TEMPS - Internal temporary registers used by the interpreter. 

CPA | | Communicate Parameter Area. Last communicate issued to the virtual machine. 


TASK CONTROL BLOCK (TCB) 


The format and contents of the TCB Registers section will be as follows: 


TCB REGISTERS 911€/90286 BYTES 


0090/00090 
C02C/C0932 
9045/0N064 
3560/C09096 
9060/690128 
9040/09160 
36€C€/69192 
VCEC/OI2246 
9106/00 256 | 
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. Next to the title is the length given in bytes. Below the section title, the relative byte address of the first 
register of each line is listed. Next to each address is an unedited hexadecimal printout of the contents of those 
registers. The contents of the MISC section are included in this section. 


_ MESSAGE (MSG) REFERENCE AREA 


The format and contents of this section will be as follows: 


MSG REFERENCE AREA Q000/00000 BYTES 


This section contains an unedited hexadecimal printout of the program’s message reference area. 
DATA SEGMENT TABLE > 


The format and contents of this section will be as follows: 


OATA SEGMENT FABLE 0950700089 BYTES 


CS9C/00900 8210 0090 1388 234A 8510 OEDS ONCS 6879 9200 0000 00A3 3602 1210 0008 0000 0000 
J020/C0)032 1200 0009 0000 0000 8710 OEGB 0126 408A 8310 OFI0 OIFE 3031 8310 OF24 O020 6C85 
0040/G00646 871C OF 25 OG20 6C43 8710 OF 26 O20 6C64 


CONTROL STACK 


The format and contents of this section will be as follows: 


CONTRAL STACK 0212/90530 BYTES 


3990/0990 | 0000 
10 26/60032 ! ! TEFO 
004C6/C9966 0000 
366C/G0996 } 0000 
3930/00128 0000. 
394C/00160 0000 
9006709192 ) 0000 
OCEC/09226 , 0000 
0166/09256 0000 
0120700288 do00 
0140700320 0000 
0160/00352 : 0000 
3130/00384 0000 
0100709616 , BFC2 
O1CC/00668 : 5238 
01£6/02480 0000 
0200700512 0000 


This section of the listing is an unedited printout of the control stack. 
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DATA SEGMENTS 


The format and contents of this section will be listed as follows: 


OATA SEGMENT 00 2710710000 BYTES 


SEGMENT ATTRIBUTES? 


PRESENT 

LUCKLD 

READ/WRITE 

cC26/70G000 0101 0178 0101 0188 0184 O1FB 01786 O1FBH 010C O1FB 0101 O1F8 0107 0207 0002 020€ 
226/000 32 0106 9210 O107 O2AF C101 O2AF 010C 0286 0101 0286 0107 D2C2 0103 0209 0101 O2C9 
JOS S/CI0648 COC2 O2CA 0101 O2CA C284 O2CA 0101 O2CB 0120 O2cc 0281 O2cCC FFOO 0000 FFOO 0000 
Wo0/0I0 96 FFOO 0090 FFOO OCOO FFOO 0901 FFOO 0000 FFOO 0000 FFOO O1F2 FFOO O1DA FFIO 0090 
UVISIC705128 FFOO 0000 FFOO OCOO FFOO OCCG FFOO 0000 FFOO 0000 FFOO ONBO FFCO-0040 FFOO 0000 
JJaC700 160 FFOO 0090 FFOO OCAE FFOO 0000 FFOO O1F8 FFOO O24C FFOO O3FC FFOD 0000 FFCO O02F 
9UCC/0I1192 FFOO 0024 FFOO OU2F FFEO 0024 FFOO O24C FFOO OU3FC FFOO 036C FFOO OCOO FFOO OCODD 
JCEG/00224 FFOO 32CO FFOO OGNO FFOO OCOO FFOO 0000 FFOO NOVO FFOO 0000 FFOO 0000 FFOO OOND 
0100709256 FFOC 9000 FFNO OCOO FFOO OCCO FFOO 0900 FFOO O000 FFOO 0001 FFON 0CO1 FFOO 0000 
0120700288 FFOO FFBB FFOU OO00 C107 O2EC 0101 O2EC 013C O2F3 0120 O2F3 0117 O2F3 0101 O2F 3 
916C/CI2 20 0106 O32F O10£ 0335 C501 OCOO 0550 ON00 0106 0343 010C 0349 1506 OCOD 190cC 0000 
JIeG/CIS52 9000 LOI0 0000 0000 COU0 OCU 0000 0090 0000 0000 OUND OOLLY vONN OCC1 C2C3 C4C5 
013C/09035 84 CoC? C8C9 N1D2 0304 O506 0708 OVE2 ESES ESES E7EB E9FO FIF2 F3F4 FSF6 F7TFB F940 
91AaC/C69416 SAGB 4040 4E50 SASB SU5D 5E60 6168 GCOE 6F7A 7B7C 7E7F 7F00 ON00 0041 4243 4445 
JICC/CO44S 4647 6849 GALS &COD GEGF 5051 5253 5455 S657 5859 SASSO 3132 3334 3536 3738 3920 
JIVEC/CI44a0 — SHAE SC28 2826 SD24 2A29 3820 2F2C 2536 3F3A 2340 3022 0000 0000 0620 202N 2020 
020G/0I512 3531 5651 2C20 2020 2020 2620 2020 2020 2033 3220 2024 2020 4153 5349 &74E 4544 
V220/U0544 2020 2020 2020 2041 4045 44% 2020 2020 2020 2020 2020 2020 2020 2020 2020 2029 
O24U/0')576 2020 2020 2020 2C20 2020 2C20 2020 2020 2020 2620 2020 2029 2020 2020 2020 2020 
JVEbU/U9008 2020 2020 2020 2020 2020 2C20 2020 2020 2920 2000 0000 0100 0100 0000 0100 0100 
VAC CISD 09G0 6100 0100 O0GO C100 0100 000 0100 0100 0000 C100 0100 0000 9100 0100 oONnD 
JZAC/UI7T2 O1VO DIVO DOYO LU1VUO C1V0 OUC OUUO 00S0 $050 3050 5050 2020 2029 2020 2020 2620 
O2CT/CVWCS $920 6340) S342 3830 32900 0010 0000 O00 FFS6 FFFB FFFF FFFFE FFFF FFFE OnCO 0090 
J2E0/007 36 0990 0990 0000 0600 C000 JC00 3050 3030 3030 3000 0900 OV0O 0000 OUND GOLD 0000 
VSUS/0N768 0000 0000 9000 0090 COON OCOD 0000 0000 0000 O0V0 ONDN OH00 Of00 NVO0 DDD0 NODD 
J326/09800 0000 0000 0000 OCOO CO00 OCNO 0000 OOF1 F3F5 FIFO F054 494F 44654 &E20 2020 2020 
J54CE/00332 2020 2000 VOVUO 0000 Cd20 2620 2020 2020 2620 2020 2015 0600 0019 OCOO U014 0200 
JV3SOC/CII64 0014 0200 0214 0200 0416 8400 0419 0CO0 0019 0100 OU01 7801 FBFF 0013 FAFF O000 
I380/C0896 STFF OO14 29FF OCOO 20FF OC14 49FF 0000 2601 7803 C501 3C03 C501 0ND3 C501 0793 © 
NSAGSNIIZS EN01 3€C04 0101 0604 C101 VEO4 OFUT 0404 2401 7804 3001 7804 8501 OCOS 2DFF v000 
O3CC/Cl IDO OVFF 0000 2746 5249 2032 3920 4196 5220 3737 2020 44469 5348 2041 5245 4120 $553 
JVSEUS0OI9I2 4147 4520 4646 2044 SOZE 6946 20463 4053 4238 3030 2020 5345 5249 L14C 206E 4F2E 
VSCEN1026 2031 3335 3739 3020 2046F S74E 4552 2054 494F 4454 4E20 2021) 2020 2020 2020 2050 
3420/01056 4147 4520 2020 2051 2620 2C20 2020 2020 2020 2020 2020 2020 2020 2020 2041 5245 
J440/01068 4120 166 6452 4553 S320 2020 4152 4541 2040 454F 4756 4820 2020 2053 S441 5455 
046C6/01120 3320 2020 2020 2020 2046 494C 4520 4F41 4045 2020 2020 2020 2020 2020 2020 2020 
C48C/C1152 2020 2020 2029 2020 2020 2620 2020 2020 2020 2020 2020 2020 2020 2020 2020 2020 


This section of the listing contains information about each of the program’s data segments. The segment’s size and 
attributes are obtained from the data segment table. Following this information, is an unedited hex dump of that 
segment. . . 


When a data segment is assigned the attributes ABSENT and FIB, the virtual machine had not yet formed that 
segment at the time of the dump. A sample of this is shown in the following: 


DATA SEGMENT O02 0146/00326 BYTES 


SEGMENT ATTRIBUTES: 
PRESENT 
LOCKED 
READ/WRITE 
FI8 


Data segment 00 contains all the data descriptors for the task. It is the data stack. The information contained in | @ 
segment OO is further analyzed during the control stack analysis. | 
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FILE ANALYSIS 


This section of the listing contains information about the task’s files. A sample analysis is shown in the following for 
both open and closed files. 


FILE ANALYSIS 


€ OPEN ) 


FI38 SEGMENT 0902700002 
FPG SEGMENT 0007700007 
FILE STATE: 

WOLTE 

OUTPUT 
FILE TYPE 2093 DATA 
DEVICE KIND | UNKNOWN 
RECORD LENGTH 0000/00000 — 
BUFFER LENGTH 0090700000 
® BUFFERS 06000/50000 
MAX FILE SIZE 230000002 
MYUSE ILLEGAL 
OTHERUSE LOCK 
ACCESSMODE ILLEGAL 


FILE / (CL OSEO) 


FIB SEGMENT 0003700003 
FPB SEGMENT 0008/00008 
FILE TYPE 2033 DATA 
O€VICE KINDO UNKNOWN 


RECORD LEKGT4 0000700009 
SUFFER LENGTH 0000/0G000 
8 BUFFERS 0090790900 
MAX FILE SIZE 39000008 
MYUSE ILLEGAL 
OTHE PUSE LOCK 
ACCESSMOOE ILLEGAL 


CONTROL STACK 


This portion of the dump decodes the information in the stack and lists the data descriptors and data values 
of all the task’s currently active variables. The analysis begins with the oldest procedure and progresses level 
by level to the most recently called procedure. A sample analysis is shown in the following. 


CONTROL STACK ANALYSIS 


NEXT LEVEL 
PSN 0000700000 REG1 0000700000 
SPN 0000700000 REG2 0000700000 
PCA 0220/00544 NLO- 0058700088 
LVL 0000700000 LSA 0018/00027 
ADDRESS DESCRIPTOR OCCUR DATA TYPE SEG ORIGIN DATA 
009979C000 01010178 000 CHARACTERCO01) 00 0178 c1 bo as 
0004/00004 01010188 001 CHARACTERCOO01) 00 01868 41 "a" 
0008/0C008 0168401F 8 002 CHARACTER(180) 00 O1FB 202020 20203 531363120202020202020 °* 5161 ~ 
202020202020333220202020620415353 °* 32 ASS* 
SIKTEE SS 442020202020 20204140454E “IGNED AMEN? 
44202020202020202020202020202020 "0 ma 
202020 20202020202020202020202020 * = 
20202020202020202020202020202020 °° as 


202020 20202020202020202020202020 ° 
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REGISTERS 


The registers and their functions are listed in the following table. 


| Data Stored in Register 


PSN SPN 


The segment number of the currently active procedure. The procedure number of the currently active 
procedure. 
The address of the S-instruction currently being executed. 


PCA 


ae ' The lex level of the currently active procedure. 

REG? The lex level of the most referenced region. 

NLD The lex level of the most referenced region. 

LSA The number of local descriptors in the procedure. 

; The size of the literal pool for the currently active: procedure. 


DESCRIPTOR INFORMATION 


The descriptor information is formatted into seven columns with the following headings: 


ADDRESS : The byte offset into segment 00 of the start of the data description. 

DESCRIPTOR The actual value of the four-byte descriptor. 

OCCUR The occurrence number of the data descriptor. 

DATA TYPE The data can be of five types: FIXED, Bit (00=00), MSG REFERENCE, SELF RELATIVE, and 
CHARACTER (000). The BIT data type is followed by parentheses. The data enclosed is: bit 


position=bit length. The CHARACTER data type is followed by its length enclosed in parentheses. 
SEG The segment number of the data. 
ORIGIN. The byte offset in segment <SEG> of the data. 
DATA The value of the data stored at that address. 


COBOL DUMP ANALYZER (COBOLDUMP) 


The COBOL Dump Analyzer is a debugging aid for the programmer. When a COBOL program is DP-ed, 
a dump file is created on disk. COBOLDUMP examines this file and arranges it into an easily readable format. 


OPERATING INSTRUCTIONS 


COBOLDUMP may be executed any time the system is operating by entering via the system console: 
COBOLDUMP filename HEX 
“filename” is the name of the dump file created when the COBOL program was DP-ed. It will reside on the 
same disk as the program code file. 


HEX is an option that, if entered, will produce an unformatted dump. Default is a formatted dump. 


After a formatted dump, COBOLDUMP will go to EOJ. After an unformatted dump, the program will dis- 
play the message FORMATTED DUMP?. If a formatted dump is desired, the alphabetic character Y is entered 
via the AX command. COBOLDUMP will terminate automatically after the formatted dump. If the formatted 
dump is not desired, the alphabetic character N causes COBO .DUMP to go to EOJ. 


ERROR MESSAGES 
The same error messages, causes, and corrections apply to COBOLDUMP as was defined for MPL2DUMP. 
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EXPLANATION OF FORMATTED DUMPS 


This section explains and gives examples of a formatted dump analysis listing in the actual order listed. 


NOTE 
Whenever both the hexadecimal (hex) and decimal values are given, they will. ap- 
pear in the form: 


HHHH/DDDDD 


where 
HHHH is the hex value and DDDDD is the decimal equivalent. 


The following paragraphs explain the individual sections of the analysis. 


HEADING 


The format and content of the first page heading section of the printout will be as follows: 


COBOL DUMP/ANALYZER 


DATE = 04/29/77 

OUMPFILE NAME = QOOO0O00/0MF ILO1 
CODEFILE NAME $s CMS20T/TEAM=STATS 
REASON FOR DUMP 3: O UNKNOWN 


The actual data, program identification, dumpfile identification, and reason for the dump will vary accord- 
ingly. 


PROGRAM PARAMETER BLOCK (PPB) OF CODE FILE 


This section of the printout defines the structure within the code file and provides identifying information con- 
cerning the program. 


The format and content of the PPB section of the printout will be as follows: 


PPB OF CODE FILE 


IMPLEMETATION NUMBER 
PRUGRAM NAME 
SeLANGUAGE NAME 
INTERPRETER PACK 
INTERPRETER NAME 
CUMPILER NAME 
COMPILATION DATE 


00 
TEAM@STATS 
COBOL 
oo00c0co 
COBOLINT 
SLO/CCBOL 
O3/11/77 
0400 

FF 
00 
0017 
0006 
0007 
003C 
0008 
003C 
0234 
0003 


PRICRITY CLASS 

INIT SEGMENT NUMBER 
INTERP ENTRY SEGMENT 
INTERP ENTRY OYSP. 
PST LENGTH 

PST LOCATION 

OST CENGTH 

DST LOCATION 

STACK LENGTH 

COP TABLE LENGTH 
COP TABLE ADDRESS 
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\ 


The program parameter is listed and the field content it stores is listed r next to it. The table below identifies 


the field content. | @ 


IMPLEMENTATION | Level number of the implementation. 

NUMBER 

PROGRAM NAME Name of user’s program. 

S.LANGUAGE NAME Name of language created by compiler. 
INTERPRETER PACK Pack on which the interpreter resides. 
INTERPRETER NAME Name of interpreter. 

COMPILATION DATE Date of compilation. 

PRIORITY CLASS Priority class of program. 

INIT SEGMENT NUMBER Initiating message segment number. 

INTERP ENTRY Segment in which execution of. the program begins. 
SEGMENT 

INTERP ENTRY DISP. : Byte displacement into interpreter entry segment at which execution begins. 
PST LENGTH Length of program segment table. 

PST LOCATION Location of program segment table in CODE-FILE. 
DST LENGTH Length of data segment table. 

DST LOCATION Location of data segment table in CODE.FILE. 
STACK LENGTH Length of control stack. 

COP TABLE LENGTH Length of current operation table. 

COP TABLE ADDRESS | Location of current operation table in CODE.FILE. 


TASK CONTROL BLOCK (TCB) PRESET AREA 


The format and content of the TCB section of the printout will be as follows: 


1CB PRESET AREA | | | © 


S*START PCA 
S“START PSN 
LAST COMM RESP 
CURRENT OP 


0034 ¢ S2) 
0000 ¢ 0) 
000000 

OO2F 


PSN : 0068 
ISN : 0013 
DSY BASE : 2271 
OST LIMIT s 2299 
TOP OF STACK s 22C2 
STACK LIMIT 3 22F 8 
MCH TOS RECOVER : 0088 
MCH ACTIVE VERB =: OO7A 
TCBeFLAGS s 0051 
MRA.BASE H 2271 
COMM RESULT A $ 0040 
COMM RESULT 8 : Q000 


OVERFLOd FLAG 0000 (RESET) 


LINE COUNT 2: 076°C 118) 

A REGISTER : 0009 0000 OoC00 0000 
8 REGISTER : 0000 0000 ocoOo o0cdo 
C REGISTER : 0006 00G0 ccCOO 0000 


0¢900 0000 0000 0000 OC90 0000 0000 0000 0000 0000 0000 0000 0000 0000 2070 0452 FFFF 
001764 C000 0000 O00C0 CCOO 8000 0019 0420 2096 8000 0014 042A 2091 0000 0000 C000 0000 
00126 OO2F 11aF OOOO 18CF OOGD NE7C 11C9 001A 101F OOOO 0076 0000 ON0NO N00 0000 0000 
00192 0001 0000 8000 CCOO0 0002 0000 0000 0900 0000 0000 0000 0000 0000 0000 0000 0000 
00256 C900 0000 0000 OCOO 0000 N000 00G0 0000 0000 0000 0000 0000 9000 0000 0000 0000 
00320 0300 0000 0002 OCOO0 0N48 NNO2 0002 0000 0000 a000 0000 0000 0000 0000 0000 0000 
00384 1021 0000 00G0 OCO0 0000 0000 0000 0000 0000 0000 0000 0000 0000 0103 0000 0040 
00448 0000 0000 0000 0000 0000 0088 0000 0000 0000 0000 BFAYX 015A C101 BFBO 0000 310F 
00512 0116 FF72 
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The preset program parameter or register is listed and the field content it stores is listed next to it. 


Register 


PSN/ISN The first 12 entries of the task control block, reflecting the entry numbers in the slice descriptor table 
— of the program control block and the interpreter. 

DST BASE Absolute address of the base of the data segment table. 

DST LIMIT Address of last entry of DST + 1. 

TOP OF STACK Absolute address of base of partial interpreter stack. 

STACK LIMIT Address of last entry of stack + 1. 

MCH TOS RECOVER Difference between the present top of stack and the base of the task control block. Used for error 

recovery in the master communicate handler. | 

MCH ACTIVE VERB Relative address of the current program address from the base of the task control block. 

TCB.FLAGS | Flags used by the operating system to interface between system modules. 

MRA.BASE Address of base of message reference area (used by data comm). 

COMM RESULT A - Result of an I/O communicate. 

COMM RESULT B Result returned by an operating system module. 

S-START PCA Program count address. The interpreter’s offset into the current program segment. 

S-START PSN The interpreter segment offset into the program’s code file. 

LAST COMM RESP Last Communicate response. 

CURRENT OP The operation currently being executed. 

OVERFLOW FLAG Indicates if overflow is present. 

LINE COUNT Line of program currently being executed. 

A REGISTER Contents of the registers that the interpreter uses for numeric operations. 

B REGISTER | 

C REGISTER 


DATA SEGMENT TABLE 


The format and content of the data segment table section of the printout will be as follows: 


DATA SEGMENT TABLE 


This section contains an unedited hexadecimal printout of all eight-byte table entries. 


CONTROL STACK 


The format and content of the control stack séction of the printout will be as follows: 


CONTROL STACK 


003090 0114 8490 2020 2020 
00964 5441 2049 0000 0000 

. 00328 0000 O0C950 0000 0000 | 
00192 0000 0000 0000 0000 
00256 0000 OCOO 0101 8000 
00320 — 0100 0037 0007 


The control stack dump is an unedited hexadecimal printout of the control stack contents. The first column 
of the printout gives the decimal values of the control stack address of each first hexadecimal character in that 
row. Each control stack entry consists of three words, the last entry being at the head of the control stack. 
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The format of each entry IS: 


First Word, First Byte K. — Value sometimes used by the interpreter to determine whether or not to use the 
? stack entry to obtain the address of the next S-instruction to be executed. 


First Word, Second Byte Segment No. - The number of the code segment. | 
Second Word Digit displacement of the next sequential instruction relative to the segment base. 
Third Word | Line Count - Line of program being executed. 


DATA SEGMENTS 


The format and contents of this section will be listed as shown in the following: 


DATA SEGMENT 0000700000 


00900 0900 0000 0000 0000. 0000 0000 oD00 0000 0000 0000 0000 0000 0000 0000 coo0o oon0 
00064 0000 0000 0000 0C00 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 


00128 0000 0090 0000 OCOD 0000 0000 0000 0000 0000 0000 0000 0000 0000 0900 0000 c000 
00192 0000 0000 0000 OC00 00C0 0000 0000 0000 0000 0000 0000 0000 0000 0000 2000 0000 


10256 6990 0009 0N00 OCNN CONG 0000 2100 B02N 0N54 ONBO 2000 5401 BNZ23 ONBO 2156 02Rn0 

00320 0N00 0000 0000 OCGO 0000 0000 0000 0000 0000 o00U 0000 OD000 0000 0000 Q000 0009 

00384 5052 4SF47 5241 4020 4142 &F52 5445 4420 2020 5553 4520 5052 4F43 4544 $552 4520 

OC648 = 4049 5353 494E &S7T4E 4F20 5459 5045 2032 4ESF 2054 5950 4520 3150 S26F 6752 4140 

00532 2041 424F 5254 4544 2020 204EF 4F20 5354 4FSU 2052 S5S4E 2045 bE 43 4F9S b6ES& £552 

505162. ashe : & 
00909 0000 9000 0000 OG00 0000 0000 0000 0000 09ND oDnD OCNO ArNO 0200 9000 C909 CONN 


C0064 €900 0000 0000 0C00 0000 0000 0000 0000 00900 a000 0000 0000 on00 0900 OCO0 0000 


00128 0000 0000 0000 OC00 0000 0000 0000 0000 9000 0000 vo00 0000 oo00 0000 0000 oco0 
00192 0000 0000 0000 OCOD 00CO 0000 0000 0000 0000 0000 0000 0000 0000 oDDD 0000 0000 
00256 CO00 0000 0000 OC00 CONN NNCO 2100 8020 0054 0080 2000 5401 8023 00RD 2154 0280 


09820 0000 0000 0000 OCOO 0000 0000 0000 0000 00ND 0009 0000 00ND 00ND 0000 9DC0 ODN? 
00384 9052 4F47 S241 4020 4142 4FS2 5445 4420 2020 5553 4520 5052 4F43 4546 $552 4520 
00448 4049 5353 K94E &7T4E 4F20 54659 5045 2032 4E4F 205% 5950 46520 3150 S26F 4752 414D 
00512 2041 424F S254 4544 2020 204E &F20 5354 4F50 2052 S5S4E 2045 bE43 &FSS &ES& 6552 
00%7b 45944 | 

DATA SEGMENT 0001700901 


0000 0009 0000 0900 OCOO 0000 0000 0000 0000 0000 0000 00ND 0000 0000 o000 0000 0000 
00064 0000 0000 0000 OC00 0000 


DATA SEGMENT 0092/00002 


@See@@eeweoeanan ean eane ae aan n ana ee @ @ 


00900 0030 3030 3030 3C30 4441 5441 2049 &£20 2020 2020 2030 3031 0000 0000 1104 0000 
00064 0030 0030 0000 0002 00C0 3108 3031 0000 3737 3131 3900 0000 O000 0000 3030 3100 
00128 0000 0000 0000 6000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 oD000 
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This section contains a unedited hexadecimal listing of each data segment. 


CURRENT OPERATION (COP) TABLE 


The format and content of the COP table section of the printout will be as follows: 


COP TABLE 
coP TYPE LENGTH OISPCDIGITS) SEG NUM DATA 
0 U-4 5 0 0 00000 
1 LS-4 3 38 0 0000 
SUB FACTOR O 3: 4 
TABLE BOUND 3 48 
3 U-8 3 66 0 000000 
& U-8 1 92 0 00 
3 un8 1 94 0 090 
6 U-8 1 96 0 00 
7 uU-8 1 98 0 00 
8 uU-8 1 100 0 00 
U-8 1 102 0 00 
un8 1 0 00 
U-3 1 0 00 
U=4 3 0 000 
LS-4 0 


0562020202020 
5654550494E 47 7 


1 5 
108 U-8 7 310 8 S343 4FS2494E47 
109 U-8 11 390 8 G74F 414 C4B 454550 494E47 
110 U-8 131 412 8 20205 1205653204F S0504F4E454E5420202020202020202020202020 
2020202020202020202020202020202020204E 4140452 2926202020 
20202020 20202920202047 20262041202 05450202020202020202047 
&F 414048 4545504552202020202 029202 02020205045522E 2047 SF 41 
6C532020415647 2E205341564553205043542E 
111 u-8 14 416 8 51205653 2046F SOS04F 46£454E5420 
112 U-8 & 504 8 GE 414045 
113 u-8 9 S44 8 47202020 4120205450 
114 U-8 10 578 8 474F 4140 4B4549504552 
115 U=B 27 620 8 50455226 2047 4F 414053 2020415647 2620534 156455320504 3542E 
116 u-8 2604 674 8 000000000000600000000000000000000000000000000C0000000000 
00000000 000000000000000NNDDDNNDDNDDNNDON ONDONCONOONCOOND 
END COBOL? 


The dump of the current operation table lists the contents of all declared variables. The information consists 
of: 


COP Table entry number. 
TYPE Data type, may be one of the following: 
U-8 8-bit unsigned 
LSS-8 8-bit separate leading sign. 
LS-4 4-bit leading sign 
LOS~4 8-bit overpunched leading sign 
U-4 4-bit unsigned 
TSS-8 8-bit separate trailing sign 
TS-4 4-bit trailing sign 
TOS-8 8-bit overpunched trailing sign 


LENGTH Data length. This is a decimal number and does not include a sign unless the sign is 
overpunched. 
Digit displacement. 
Segment number. 
Unedited hexadecimal printout. Data may be: 
The first item will appear, followed by: 
SUB FACTOR (no. of subscript) : (subscript factor) 
TABLE BOUND : (table bound) 
The first item will appear, followed by: . 
INDEX : (no of indexes) 
TABLE BOUND : (table bound) 


DISP (DIGITS) 
SEG NUM 
DATA 
SUBSCRIPTED DATA 


INDEXED DATA 
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SECTION 10 
B 1800 DEPENDENT ROUTINES 


STAND-ALONE UTILITIES 


The stand-alone utilities perform specific functions but not under MCP control. The stand-alone utilities avail- 
able are: 


NAME FUNCTION 
COLDSTART Loads system software to disk from a CMS library magnetic tape. 
CLEARSTART Determines the system configuration, builds tables and places the system under MCP control. 
PACK. INIT Initializes a disk pack to CMS format. 
CART.INIT Initializes a disk cartridge to CMS format. 


All these stand-alone utilities are initiated in the same way: 


B 1860 System 


1. Place the cassette in the cassette reader on the control panel. Rewind if necessary so that BOT light is 
illuminated. 


2. Set register select switch so that it points to the L register. Set cassette switch to SYSTEM. Ensure that 
SINGLE MIC/CONT switch is set to CONT and micro select to NORMAL. | 

_ 3. Set MODE switch to the MTR position. Press the CLEAR and then the START buttons. If the cassette 

does not start press HALT and CLEAR simultaneously and then START. After reading the cassette the 


system will halt with @AAAAAA @ in the L register. The T register will display the release level, for 
example, @030100@. 


4. Set MODE switch to NORMAL position and press START button. This will load the program and begin 
execution. 


B 1830 System 


1. Place the cassette in the cassette reader. If cassette is not at BOT it should automatically rewind. 
2. Enter ST. 


3. Press the CLEAR and START buttons. 
4. Enter CR23 (this is the L register). 


R23 “0101 0101 0101 0101 0101 0101 AAAAAA” should print. 


5. Entering CR22 (this is the T register) would display the release level. 
R22 “0000 0011 0000 0001 0000 0000 030100” should print. 
6. Enter SR and press the START button. The program will load and begin execution. 


The following halts are common to all stand-alone utilities: 


CONTENTS OF L DESCRIPTION 
@111111@ No channel with ODT attached found. 
@222222@ Invalid response after a TEST SERVICE REQUEST. 
@333333@- Invalid status. 
@444444@ Memory Parity Error. 
@555555@ Invalid Result Descriptor. 
@666666@ ODT not ready. 
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Coldstart 


Coldstart will load system software from a single-reel CMS library tape (tape-id CMS) to disk, either disk pack @ 
or disk cartridge. The tape can be either 800 BPI NRZ or 1600 BPI PE and any tape unit may be used. 


Operation 
“B_ 1700/1800 CMS COLDSTART” will be displayed and the operator will be asked to provide information: 


QUESTION : CMS DISK DRIVE <DPX> OR <DKX> 
RESPONSE : Enter disk drive on which the system software is to be loaded, for example DKA. 


NOTE 
This disk must have been initialized previously using the appropriate CMS disk initializer. 


QUESTION : CMS MAG TAPE UNIT <MTX> | 
RESPONSE : Enter the mnemonic for the tape unit on which the coldstart tape is loaded. 


QUESTION : DISPLAY LOADED FILES ? <YES OR NO>. 
RESPONSE : Enter “YES” if a list of files loaded is required. or ‘““NO” if no list is required. 


The tape label will be read and the following message will be displayed : 


CREATION DATE OF TAPE : MM/DD/YY 


This information is obtained from the label of the tape. 


QUESTION : LOAD ALL FILES ? <YES OR NO> | © 
RESPONSE : Enter YES if the loading of all files is requested, or NO if only some specific files or families 

of files are only required. 

A NO response will generate the TOnOwINe message: 


QUESTION : ENTER FILE NAME <12 CHAR OR ETX> 
RESPONSE : Enter the name of the file or the family of files requested. This message will appear until 
a blank entry (ETX ONLY) is made or the limit of 20 entries has been reached. 


NOTE 
Introducing a file name or a family name with no corresponding entry in the directo- 
ry of the tape will display the error message : ““THIS FILE IS NOT ON TAPE” 
and the operator will be asked to enter another file or family-name. 


Then, if requested, the message : 
LOADED FILES : 


is displayed followed by the names of the files, maximum five per line, loaded to disk. When the processing 
of COLDSTART is finished, the message “END OF COLDSTART” is displayed. 


Error Messages 


The following error messages may be displayed. The action to take is noted except where the message is self- 
explanatory. 


1. “TAPE IS NOT A B 1800 CMS COLDSTART TAPE”’. 
Attempt to COLDSTART with an incompatible tape. Check that the tape unit was specified correctly and 


that the tape is a CMS library tape. If the tape unit was specified correctly and the mabe is a CMS tape © | 
but its file-id is other than “CMS”, COLDSTART will continue. 
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2. ‘MAG TAPE NOT AT BOT. CORRECT AND START”. 
“MAG TAPE NOT READY. CORRECT AND START”. 
“MAG TAPE LOCKED. CORRECT AND START”. 


Problem with the tape unit. When corrected, press the START button on console panel. 


3. ‘““NOT A CMS DISK’’. 

Disk is not CMS format. Initialize the disk and rerun COLDSTART. 
4. “PROBLEM WITH MAG TAPE’”’. 

‘PROBLEM WITH DISK’”’. 


“DIRECTORY FULL”. 
“NOT ENOUGH SPACE ON CMS DISK”. 


All these are fatal errors. The disk must be re-initialized before attempting to coldstart again. 
5. “CANNOT REMOVE <file-name> - DUAL PACK FILE”’. 


The file concerned has areas on another disk and cannot be removed so the file is not loaded but the pro- 
cess of COLDSTART continues. 


Clearstart 
Function 


CLEARSTART ascertains the exact configuration of the system, builds various tables for the MCP, initializes 
memory links, executes the AVR of the system disk, loads MCP and finally passes control to MCP. 


Operation 
At the start the message “REWIND CASSETTE” will be displayed followed by the message: 
““** B 1800 CMS CLEAR START MARK 3.01.LL ##*# MM/DD/YY COUNT NNNN” 

where : LL is the Patch-level maintained in MCP.INIT and updated by PATCH.MAKER. 

MM/DD/YY is the creation date of the MCP as contained in its DFH. 

NNNN is a decimal count maintained in the SYSCONFIG file and incremented by one at each 

CLEARSTART. 
Then the operator will be asked to supply the date by the message: 

“DATE PLEASE <MM/DD/YY>”’. 
The date input must conform exactly to the format specified and is checked for validity. If an error is detected, 
“INVALID DATE” is displayed and operator will again be asked to supply the date. 
Then the operator is asked for the time by the message: 
“TIME PLEASE <HHMM>’”’. 


The time must be entered as four digits and will also be checked for validity. If not valid, then “INVALID 
TIME” is displayed and the process is repeated. 


2007258 7 10—3 


If a 400/750 LPM line printer is connected to PC-5 then the operator will be asked to enter the type of train 
by the message: | 


* LT REQUIRED FOR LP <x> 
enter “ LT LP <xX> <train-id>” 


The final action of clearstart is to display the location of the system disk with the message “<mnemonic> 
<unit> ON LINE LAB <disk-id> # <serial-no> (S)”, for example : | 


DKA ON LINE LAB SYS # 123456 (S) 


then control is passed to the MCP. 


Error Messages 


The display of “CLEARSTART PROGRAM NOT FOUND” means that no valid system disk (no disk contain- 
ing MCP) is on-line. So correct and then press the START button. 


The CLEARSTART process may also halt with @ FFFFFF @ in the L-register (R23 onB 1830). It means that the 
system disk is locked therefore inhibiting any write on it at AVR time. Switch the disk to WRITE ENABLE 
and press the START button. . 


Disk Initializers (Cart.Init/Pack.Init) 


General Information 


All disks must be initialized to the CMS format before they can be used under MCP control. Each initializer 
comprises six basic passes: — 


. Write addresses for every sector on the disk. 

. Verify all addresses on the disk. 

. Write a data pattern of @00@ throughout the disk and verify that the pattern has been written correctly. 
. Write and verify with a pattern of @FFQ@. 

. Write and verify with a pattern of @55@. 

. Write and verify with a pattern of @E5@. 


Nn BR WN 


For disk pack only the verification in passes 3 through 6 consists of three sub-passes: 


1. With normal offset. 
2. With offset in. 
3. With offset out. 


Each I/O operation is retried 5 times and a count is kept of the number of retries (this appears on a KA or 
LR as the field ERROR COUNT). If an I/O operation is not successful after 5 retries the action taken depends 
on the type of disk and the operation attempted. 


For disk pack an attempt is made to relocate the bad sector (5 spare sectors are available per cylinder for this 
purpose). If the sector cannot be relocated or 5 sectors have already been relocated the track in which the sector 
lies is removed in its entirety. 


For disk cartridge, discovery of a bad sector causes the track to be removed. If during passes 1 or 2 any sector 
in cylinder zero is discovered to be bad the initializer terminates. 


Error Limits 
The disk will be regarded as unusable if: 


1. The total number of retries exceeds 75. 
2. The number of removed tracks exceeds 5. 
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After initialization the Disk Label and Disk Directory are built. The Disk Directory will start at the first Track 
after Track 0 where the total Directory (Available Table + File-Name List + Disk File Header) can be located 
in its entirety. 


Operating Instructions 
The operating instructions are similar for both initializers. After the cassette has been loaded, the title will display: 


“CMS DISK CARTRIDGE INITIALIZER MARK 3.01.00” for cartridge 
“CMS DISK PACK INITIALIZER MARK 3.01.00” for pack. 


Parameters are entered interactively. As each field is input, it is checked for validity. If not valid, a suitable 
message is output and the field can be re-entered. 


Cartridge 


Q : WHICH CARTRIDGE - <DKX> 
R : Enter DKA, DKB, ..... DKH 


Pack 


Q : WHICH PACK - <DPX> 
R : Enter DPA, DPB, ..... DPH 


Both 
Q : ENTER 6 DIGIT SERIAL NUMBER , 
R : Enter a number in the range 000000 — 999999 
Q : ENTER PACK.ID. 
R : Enter a maximum 7 characters (the set of valid characters is ‘“‘A” through “Z”, “0” through 9”, ‘“.” 
or oo) : 
Q : ENTER CARTRIDGE TYPE <R OR NOTHING> or ENTER PACK TYPE <R OR NOTHING> 
R : Enter R or leave blank. 


NOTE 
R means Restricted disk which is not implemented yet. 


Q : MAX NB OF FILES (UP TO 2803) 
R : Enter any decimal number between 1 and 2803 
NOTE. 
The default value is 254 for cartridge and 2803 for pack. 
Both 


Q : ENTER DATE <MM/DD/YY> 

R : MM/DD/YY 

Q : ENTER OWNER’S NAME (UP TO 14 CH) 
R : Enter a maximum of 14 characters 


The disk will now be initialized. While initialization is executing, the entry of <ETX> and depression of the 
“XMT” button will display information concerning the initialize: 


1. For pass 1 or 2 the message will identify the pass and the current cylinder number. 
2. For passes 3-6 the message will identify whether a write or verify operation is in process, the pattern used 
and the current cylinder. 


If the message “DPEC ATTENTION” is displayed it indicates that an Extended Result Descriptor cannot be 
cleared from the DPEC. Put the DPEC Off-Line and depress ‘““CLR’’, and “MASTER CLR” buttons at the 
back of the DPEC, put the DPEC On-Line and depress “START” on the processor panel. If this condition 
persists consult your local Burroughs representative. Note that this can happen if packs other than the one being 
initialized are Powered-On or Off during the initialization. 
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When initializing a cartridge, and after completion of the sixth pass of the initialization/verification the message: 


“ENTER FINAL PATTERN (4 DIGITS) OR <ETX>” 


is displayed. This enables a user determined pattern to be used. If this extra pass is not desired simply enter 
<ETX>. of us | 


At the end of initialization, the following information will be displayed: 
—- DRIVE 
—- SERIAL NUMBER 
—- PACK-ID 
- NUMBER OF REMOVED TRACKS 


~ NUMBER OF COUNT ERRORS (NUMBER OF RETRIES) 
~ NUMBER OF RELOCATED SECTORS (PACK only) | 


If tracks were removed or sectors relocated, the address of each removed track and relocated sector is given. 
Finally the message “DP<X> INITIALIZED” or “DK<X> INITIALIZED” is printed. 


It is now possible to re-initialize another disk (if SPO input was selected) by depressing the START button 
on the console panel. | | 


SYSTEM OPERATION 


Handling of SPO 
1. B 9348-32 


The screen is divided into two parts: 


— the first 4 lines are dedicated to input data 
— the remaining 20 lines are dedicated to output data 


To transmit a message, the operator must enter the data followed by the ETX character and then depress 
the XMT button. | 


Any accepted message will be displayed on the screen in the output section. 


When the ODT is receiving information, the data received is displayed on the last line of the screen, push- 
ing up all output lines to the top. So, the last message on the screen is on the lowest line. 


Transmitting without ETX character gives: 
- on the B 1830 : 4 blank lines in the lower part of the screen. 


- on the B 1860 : the ODT remains in XMT. The operator must depress the LOCAL button and enter 
ETX to transmit the message or the LOCAL then RCV buttons to receive data. 


2. B 9346-4 


To transmit a message, the operator must enter the data then depress ETX button. 
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DUMP ANALYZERS 


Program Dump Analyzers 


When a program is DP’ed, a dump file is created on the same disk as the program file: 


For example: 
EX USER/MYPROG 
02/MYPROG BOJ PR=A TIME = 10:15:34 
DP 02/MYPROG 
USER/DMFIL02 CREATED 


02/MYPROG DPED TIME —10:20:35 


The file name of the dump file is DMFILnn where nn is the MIX # of the program. DMFILnn has a file- 


type of SYSTEM and is closed by the MCP with LOCK. If a file already exists with the same name, the mes- 
sage: 


02/MYPROG <018> WAITING USER/DMFIL02 DK DUPLICATE FILE 


will be output. The old DMFIL02 must be removed using the RM utility: 


RM USER/DMFIL02 


USER/DMFIL02 IS A SYSTEM FILE 
03/RM <ACPT> . 


AX 3 USER/DMFIL02 OK 


USER/DMFIL02 REMOVED 
USER/DMFIL02 CREATED 
02/MYPROG DP’ED TIME = 10:20:35 


A dump file can be analyzed by running DP.ANALYZER which will give the following information: 


— Program Parameters 

— Run Parameters | 

— Interface Control Block (optional) 

— Communicate Parameter Area | 

~ Control Stack (MPL)/Perform Stack (COBOL/RPG) 
— Program Segment Table 

—~ Data Segment Table 

_ File Information (FPB, FIB, Buffers) (optional) 

~ Data Stack Analysis (MPL)/COP Table (COBOL/RPG) 
~ Data Segments 7 

— Current Code Segment 

— Locked Slice 
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The syntax for DP.ANALYZER is: 


— DP.ANALYZER pack-id / 


The options have the following effect: 


SAVE will cause DP.ANALYZER to close the dump file with LOCK rather than PURGE (which is the default). 


NO.FILE will suppress printing of any file information. 
NO.ICB will suppress printing of the Interface Control Block 


NO.ARRAY is applicable only to COBOL/RPG dump files and will print only the first and last elements of any 
array. The default is to print all elements. : | 


Examples | | 


1. DP.ANALYZER DMFIL03 SAVE NO.ICB 
will expect to find a dump file called ““DMFIL03” on the system disk, will print a formatted dump listing 
omitting the ICB portion and will retain the dump file. 


2. DP.ANALYZER USER/DMFIL02 NO.FILE 
will expect to find a dump file called “DMFIL02” on a disk labelled “USER”, will print a formatted listing 
omitting all file information and purge USER/DMFILO2 at the end of job. 


oS) 


. DP.ANALYZER DMFIL04 NO.ARRAY 
will expect to find a dump file called ““DMFIL04” on the system disk, will print a formatted listing including 
only the first and the last elements of all arrays and purge DMFIL04 at end of job. 


system Dump Analyzers 


A Memory Dump listing can be obtained by running the “MEM.DUMP?” cassette in stand-alone mode to write 
the contents of the memory into a new file named “DMFIL00”, by restarting the system and executing the ‘‘MEM. 
ANALYZER” program. The file “DMFILO00” is in all cases a new file. It is created on the system disk if 
the appropriate CMS parameters in memory are not corrupted and if there is enough space on that disk. If 
this is not so, the operator must enter the channel number and the unit number of the disk on which DMFIL00 
must be created. 


1. Cassette MEM.DUMP 


Two cassettes are available, one for B 1830 systems and the other for B 1860 systems. This cassette must be 
executed in stand-alone mode so, if the system is still running at the time a memory dump is desired, it must 
be stopped with the interrupt switch or, if this is not successful, with the halt button. 


NOTE 
UNDER NO CIRCUMSTANCES PRESS THE CLEAR BUTTON 


The operating instructions to run the cassette are as follows: 


— Load value 0 in M register 

- Mount the MEM.DUMP cassette 

— Switch to TAPE Mode 

- Do not depress CLEAR 

- Depress START 

—- When register L = @AAAAAA@® switch to RUN Mode and depress START 
~ When register L = @CCCCCC®@ dump is complete | 
— Rewind cassette 

~- Perform CLEAR START 

— Analyze “DMFIL00” by executing “MEM.ANALYZER” 
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List of halts (in L register): 


@111111@ Physical error on I/O operation. 
! Pressing START will display the Result Descriptor in L register. 
@666666@ Not enough space on the designated disk. 
Pressing START goes to the next Halt. 
@999999@ Indicate in the L register, in the form ‘“0CO00U” on what disk DMFILO00 has to be created and then 


press START. | 
C is the Channel number. 
U is the Unit number. 


@AAAAAA@ : Switch to RUN Mode and press START. 
Release level is in ‘I. 
Memory load address is in X. 
Dump file size is in Y. 
Channel number is in SOA. 
Unit number is in SIA. 


@ECCCCC@ Dump is complete. 


Pressing START displays some information about the disk on which DMFILOO was created in the L 
register in the form “TCOOOU” where 

T is the Type (@0@ for cartridge, @F@ for pack) 

C is the Channel number. 

U is the Unit number. 


@FFFFFF@ Not enough space in the File Name list (Disk has a Missing Section). 


2. MEM.ANALYZER 


The listing can be obtained by invoking “MEM.ANALYZER’” with the following syntax. 
MEM.ANALYZER | 


< MFID/> 


< FID> 
This program will analyze the file ““DMFILOO” and give a listing with: 


— Form to be filled by the user 

— Form to be filled by Burroughs representative 
— Main registers 

— Last 12 entries in TAS 

— Scratchpads 

— MIX Table 

— Memory Assignment Table 

— Virtual Memory Tables 

—~ Channel and CCW Tables 

—~ Channel Control Blocks 

— Device Control Blocks 

- File Control Blocks 

- A few other System Tables 

— For each user MIX, its ICB, PST, DST, FIB’s and FPB’s. 
— A historic of the patches inserted since the release time. 


The copy of the interpreters in memory will be compared with their initial version on the system disk and the address of the 
first discrepancy, if applicable, will be displayed. 


An hexadecimal dump of all the memory actually used will be provided, except for the space occupied by the interpreters if 
no discrepancy was found. 
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APPENDIX A 
COMPLETE RAILROAD DIAGRAMS 


This appendix gives the railroad diagrams for all the CMS-common intrinsics and utilities, including SORT and CO, in 
alphabetical order. These diagrams give the complete input message formats, for ease of reference. 


For details of the meaning of these messages, refer to the text. 


In the following diagrams the <ex-option > is defined as : 


< disk-id > 


and < file-name > is defined as : 


oe adscid > eee ye < file-id > —_—__> 
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AD intrinsic 


/ < prog-name > 


AD < mix > 


< peripheral > —> 


ADD utility 


ex-option > 


” < file-name > ” | 
ADD" < load-spec > — 


< load-spec> is defined as : 


. — TO <disk-id> | < file-id > | | <BOTH> 
#1 . | FROM < tape-id > 


< group-name >= 


AMEND utili 


* < file-name> 


< ex-option > 
[oy AMEND  <file-name > 


AX intrinsic 


Ee VE. 
< mix > . < text > 


AX 


CH utilit 


* < file-name > 
. — | 
< ch-spec > 


<ch-spec> is defined as: 


<DATA> 
< group-name > [= vy TO =——<group-name 
<DATA> 7= 
< file-name > [- - vy TO < file-name = 
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CL intrinsic 


< printer peripheral > 


< tape peripheral > 


CL | 
< self-scan peripheral > 


< ICMD peripheral > 


CHECKADUMP utility 


* < file-name > 


‘<ex-option > 


HECKADUMP < tape-id> < disk-id > 


< ex-option > — 7 
pen Connon (2 saenenenienie WH CHECK.DISK <disk-id> — 


CO utility 


ex-option | | 
Toy CO — @) ——  <CO-spec1> ——G) —— <cO-spec2> 


ESTART < mix > < line-number > 


MX 
< mix > 
CLEAR 
ALL 


< CO-spec-1 > ia defined as : 


OL < disk-id >/ Ni < compiler-name>—> 


<disk-id> / < program-name > 


< CO- spec-2> is defined as : 


< compiler-option > 


PRINT 


< message-statement > 


1 < patchfile-statement > 
FILE f < sourcein-statement > 
5 : 1 < sourceout-statement > 
FI 1 < work file-statement > 
1 < printout-statement > 


indicates the allowed postions for macro cells 
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CO utility (Continued) | | | : | ye, oh @ 
Cae a gt te a ee 


The < compiler name> is defined as : 


RPG 


RPGXREF 
COBOL 

MPL 
OPTLIST 


The < compiler-option> is defined as : 


SYNTAX 
SY . 
LI 


LIBRARY 


SAVE 


GO 


The < message-statement > is defined as : 


MESSAGE —< message-text > ————> 


< patchfile-statement > is defined as : 


1 — NAME < file-name> 
1 
MFID — <disk-id > 
— PATCHFILE 
4 SID —- <fileid>= — — 
1 cone DEVICE — < hardware > 
1 , FILESIZE —< integer > 
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< sourcein-statement> is defined as : 


11 | NAME — < file-name > 
1 
1 MFID — <disk-id > 
wee §=SOURCEIN 
1. FID — < file-id> 
1 , | DEVICE — < hardware > 
< sourceout-statement > is defined as: 
1 NAME — < file-name > 
1 
1 MFiID = <disk-id > 
—— SOURCEOUT 
1 FiD ———_—s- < file-id> 
1 DEVICE — <hardware > 
1 FILESIZE — < integer > 
1 RECORD — < integer > 
- RECORDS.BLOCK — < integer > 
1 


BLOCK — < inteyer > 


< workfile-statement > is defined as : 


——-WORKFILE MFID < disk-id > — 


< printout-statement > is defined as : 


DEVICE --— < hardware >— 


— PRINTOUT 
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COMPARE utility | _ | | © 


< ex-option > 
_ ferry COMPARE 


<co mp-spec> 


_L < disk-id >/ V etna 


< comp-spec > is defined as : 
< mfid-spec-1 >—WITH —< mfid-spec-2 > 


<gid-spec-1 >— WITH — < gid-spee-2 > 


< mfid-spec> is defined as : 


_ CRD 


MTP 


<mfid>— / < file-id> DSK : <nr> <nb> 


< gid-spec> is defined as: 


< disk-id>—/— < group-id > 


COPY utility 


* < file-name > 


‘ 


< group-copy > 


a < ex-option > n 
= , COPY 


<s-file> TO < d-file> 


< group-copy > is defined as : 


sertceeci < group-name-1> TO ——— <group-name-2> —> 


<s-file> is defined as : 


CRD 
1 MTP 
PTP 
< BOTH > 
1 
<KEY> Sees 
—< file-name . 
1 RECORD <nr> 
1 BLOCK <nb> 
1 TAPE.MARKS ——  <nt> 
1 — NO.LABEL 
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COPY utility (Continued) | . 


<d-file > is defined as: 


; RECORD ene 
1 BLOCK ———__—_<nb 
1 FILESIZE —K<nf> 
1 SINGLEAREA 
1 CRUNCH 
| L-—— EXTENDING 

< file-name > 

CRD 

1 MTP 


Pee RE 


< r-spec> is defined as : 


< r-count > 


< record-key > 


= <record-key > 


t 
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CP utility 


i < ex-option > 7 E < compute-string> { | 
: CP 


< compute-string > is defined as : 


< integer > 


CREATE utility 


* —_——— < file-name > 


| < ex-option > ae 
[iv EATE < f-spec > 


< f-spec > is defined as : 


<tab >. 


RECORD <nr 
S— BLOCK <nb 
A | FILESIZE <nf 
< file-name> | N —€RUNCH 
A 
N 


EXTENDING — < file-name > 
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DA utility _ | oe ; fe @ 


<ex-option > 


/ < file-id > 


DA moo) CS disk-id > 


ONLY 


READ - 
-@ ) ——- <sector > 


-< record > 


NEXT 


DISPLAY > am eat ie , 
END > 


DFH ALL 


NEXT 
OF < file-id > 


TEMPORARY- 


< sector > 


AK12 


DA utility (Continued | | 


AVAIL.TABLE 3 ALL 


AVAILABLE 
BAD 
INVALID 


< sector > 


NAME. LIST 
NAMES 
OF <file-id> 
TEMPORARY 


- < sector > 
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ALT 
DC intrinsic 
eee 


DD utility 


FUNCTION — STORE 
e a a | 
: LD —- STORE —< ddespec >> 


< dd-spec> is defined as : 


< f-spec > < f-spec 


as zl es 


disk-id > -/ -H <fileid> ——> 
——t— <disk-id> —/ <group-id >> 


< f-spec> is defined as : 


<g-spec> is defined as: 


FUNCTION — RESTORE > 


——<ex-option >=] __ | | 
weed eicnalesellte : “— Dp— RESTORE — < ddr-spec>—> 


< ddr-spec > is defined as : 


< g-spec <g-spec> 


The < f-spec > and < g-spec> are defined the same way as in STORE FUNCTION. 
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DP intrinsic 


i 
< program-id > —> 


DP <mixno. > = / 


DS intrinsic 


DS <mix> —_ / < program-id > —_——> 


DT intrinsic 


/ <date > < time > 
,ti_ wl v4, 
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DUMP utili 


. 


< ex-option > 


* < file-name > 
DUMP < dump-spec 2 


< dump-spec > is defined as : 


1 FROM <disk-id>. | < file-id > <BOTH> 
S*4 - TO < tape-id> 
<group-id > 


EX intrinsic 


ae = i <real-store > a 
- EX < program-id > : : < text> —> 
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FD intrinsic 


FD 


SPA < height > , <width> , <offset > 


FL utility 


* < file-name> 


s 


— <ex-option> < file-name > 
[oy FL 


< group-name > 


FS utility 


< ex-option > 
sed nsunsaincuoiansttai 


< file-name > 
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GO intrinsic . - | . | | © 
| / < prog-id > 


ICMD utility | 


< ex-option > ne 
a Cee ems ae ICMD 


< ICMD-option > is defined as : 
tR— < disk-id > 


< ICMD-option> —> @ 


PG a < disk-id > 
FILESIZE ~<number > 
COPY =—— < file-name> — ICMD — TO — < file-name > : ‘a 


*-COPY — <file-name> — TO — < fite-name > —ICMD 


<_ file-name > for this utility is defined as : 


<disk-id> / <file-id> 
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IR_ utility 


we PR | < nUmber > —_——> 


KA utili 
* < file-name> 


’ 


< ex-option > < file-name > 
[oy KA 


< group-name > 
<disk-id > / 


DSKAVL 


KX _ utility | 


KX tL < disk-id > Vi < number > cae 


or 


KX 
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—— B—— 


=> 
LD utility 
See ADD, DUMP, LOAD, and UNLOAD 
LF utility 
So Le 


LIST. utility | | | 


* < file-name > 


7 < ex-option> 
on ee . LIST 


< f-spec > is defined as : 


A 
1 
N 
MTP 
PTP 
1 CRD 
< file-name > 
RECORD “—————- <rs> 
1 BLOCK . < bs > 
1 TAPE.MARKS ——<nt> 
L NO.LABEL 


| KEY> 


<r-spec> is defined as : 


——— <inar> | —L-—_— : < integer > : 


< r-count> 
< record-key> 


 — <record-key > 
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LOAD utility 


< ex-option > 


— * < file-name> 7 
LOAD———- << ee ar 
< load-spec> is defined as : 
1 TO <disk-id> @ | < file-id> BOTH> 


#1 —- FROM < tape-id> 
< group-id > 


LR_utili 


[_ < ex-option> Y —* < file-name> 
LR 


<LR-spec> 
< LR-spec > is defined as: 
< file-name > <A> 
< ASCENDING > 
<group-name > 2 7 
<disk-id> / 
= < integer > 


M22 


MODIFY utility 


* < file-id > 


[" < ex-option > 7T 
MODIFY 


< m-spec > 


<m-spec> is defined as: 


FILE —<inf>—— , —~<f-spec>—_, 
—_— CODE.FILE — < filename> —— a 
P 


PB 


<ppb-spec> — 


s 


< f-spec > is defined as : 


< file-attribute > = < attribute-value > 


PRINT.FPB 
< ppb-spec > is defined as : 


< ppb-attribute > ee < attribute-value > 


PRINT.PPB 
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eee 


MX intrinsic | | , @ 
< mix > / < prog-id> 
Mx . 3 


eer eer nneeeme neem emmmenearemeeaeenneenmmment meee np nee ern 


< peripheral > 
—— OL on 


PD utility 


< group-name > 


< file-name > 
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PG. intrinsic 


——_ PG < tape or cassette peripheral > —> 


PL utility 


< ex-option > | 
FW PL < PL-spec> 


<PL-spec> is defined as : 
SYSTEM 


S 
ERROR - 


E 


< time> 
FROM — <date> 


< time > 
TO —— <date> 


ENTRY =" <number > 
MIX —— ~~ <number > 
INPUT 

OUTPUT 
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PO intrinsic 


—— PO ——_ << peripheral > ———— 


PR intrinsic 


——— PR ——— <mix no.> / —< program-id > B 


RM utili 


* < file-name > 


< file-name > | < BOTH> 
—— RM | 
< group-name > 


RY intrinsic 


RY 


< peripheral > — > 


Henne nnn ee aaa cL 


< disk-id > 
< disk-id > / < file-id> 
< file-id > 


SF eee << mix no. > — / < program-name > 


SORT utility 


< file-name > 


E < a . 
SORT 


< sort-merge-spec> is defined as : 


< sort-merge-spec > 


< file-statement > 


< key-statement > 


< user-option-statement > 


< file-statement> is defined as : 


_ i rae me 
i. IN < I-file-spec > - OUT — <0O-file-spec> —> 


FILES 


< |-file-spec> is defined as : 


URG 


< record-size> 
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SORT utility (Continued) 


< O-file-spec > is defined as : 
DISK 


CARD — <record-size> 
TAPE 

CASSETTE 

PRINTER 

KEYFILE 

TAGFILE 


— < file-name aS 


< key-statement> is defined as : 


- ASCENDING 
A 


KEY —<— <loc> —<len> — DESCENDING 
D 


< user-option-statement > is defined as : 


- INDEX 
INPLACE 
MERGE 
NODUPLICATES 
— DUPLICATES 
- SYNTAX 
NOPRINT 
NODISPLAY 
COMMENT — <comments > 
FILESIZE — <number of records> 
MEMORY — <memory size 
- WORKDISK — <disk-name> 
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< block-size > 


ALPHA = 
UA 
NUMERIC -: 
UN 

SA 

SN 


SSA 


SO utility 


psn DY Dune Vs ws 
SO — < disk-id> ) <SQ-spec> | LIST 


<SQ-spec> is defined as : 


VERIFY : 
FAST —_———= < number > 3 . 
BEGIN — , < end address > 
FROM “f | TO 
| < start address > END 


ST intrinsic _ 


—ST 


[_ / <prog-name > y 
< mix > 


SV intrinsic 


—_— SV —— < peripheral > ——— 
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cee 
TAPELR utility 


< ex-option > 
jee TAPELR —— < tape-id >> 


TAPEPD utility | | | 
i 


[_ <ex-option > x —_ | 
7 TAPEPD ‘ <tape-id > —> 


TL utility 


a < ex-option “7 
: hte 


< disk-id > / < filename > RECOVER 


UNLOAD utili 


< ex-option > 


* < file-name > | 
UNLOAD ————— een. ati 


< dump-spec> is defined as : 


1 FROM < disk-id > | < file-id > < BOTH> 
“J TO < tape-id > 
< group-id > 


UPDATE utility 


< ex-option > * < file-name > 


<i-file> TO <o-file > 


< i-file > is defined as : 
A < tab > 


< file-name 


<o-file > is defined as : 


FILESIZE*——=<_fs> 


< file-name. 


-CRUNCH 


XD utility 


< ex-option > | 
[Vy ———= <disk-id > 7 <address> “~~ <length> | > 
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APPENDIX B 
EXAMPLES OF PRINTED UTILITY OUTPUT 


This appendix provides sample output from some of the CMS—common utilities described in section 4. 


SPO and console input messages are underlined. Some utilities use SPO display messages for output. Output print listings use 
a printer if one is available, or (for a B 80 or B 800) a console file. Print files can be either labelled or unlabelled : if a file is 
labelled, the name is printed following 


| ?DATA 
at the beginning of the listing, and 
?END 


at the end of the listing (for example, refer to the PL output listing). In this appendix, print files are shown boxed in : other 
output is on the SPO. | 


The meaning of the input messages are given in section 4. The utilities are given here in alphabetical order. 
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SYOudsa 


EGGS 
ayau 
Boas 
ayau 
4684S 


avay 


Wd 


Wd 


ooee 


Qatar LON’ °*. 


GUL 1dNOO ASIGAW NO ASTa*NIAHD 


YOLIAS ONTaVaU NO QAaQlaLLON woud 
dZ2é0 QVSd NI AVIHM WwOuds ALTYvd *"° 
WAWSAS/HSIGAWA 2 > ASIA" ADSHI/OT 


YOLIIS INTAVAU NO GATATLON YOUN 
AZ22 GYIU NT DUWHM YOUNA ALTUbd **" 
WAWSAS/ASIGAWS2 > ASIA*NISHI/OT 


YOLIAS INTAVSAY NO GSTATLON YOUUs | 


dfded AVA NT SUH wOuda ALTUvd “°°. 


WAWSAS/SASTIGAWA2 > ASIA" HOSHO/OT 


ASTUIAW ASLO" ACIS 


WALSAS HASTA GNY Adve" 


LUY Ad¥l dWONd NASMLAG SSTONVdSYOSTd ON 


SAV LAY dWAISa IaH 


B--2 


" | OzZ0Z OZOZ OZOZ OZOE Odd! Ode ee OZ02 809000 
MOH FAVHLSNONHE.0202 0202 0202 OZ02 O02 0202 OZ0Z OZOE OLS 448 OES VST AG¥S ESId 49> Shoy BOCIOD 
OL (31¥3ND Td AWWNG Y SI STHLwO24d 4502 99S% 9ST S¥2S £402 SdIY 46999 0246S Addy SGb> O2T> OCES 6402 £54% Bd7S HOODS 


sSI ¢ duO03Y C3ya/ASTUAN 


" (0202 O202 O2OE NOE O02 O20 O20e O20 807002) 
"XAOH JLVYLSNOWIIn0OE Od0e NOE OcOe Ode 0202 0202 0202 BLZS 448% OZSY IST USS ESI 490% Sod» BOZOOD 


OL 3LV3YD FIE4 AWHNG ¥ SI SIHL 02s? 4602 49SY 4OTS S¥eS £02 SHI 4474 OES Md GGYY OcTy OCES 690d LS69 8449S 00008 
2SI @ qu003Y dus 


840008 SLAG LY G3LI9L30 JINFVIIITT 


SYOUNS T - GavvdHOD G3Y4/ASTIGAN HLIM dad 
CGUA/NSIGAN HLIM (aud SuvdWO) 
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F 
arrooa/TS S3114 40 U3GHAN WAWIXYH aaz00e/£> HA 1SUI4 40 SSIuday 
0908/9 HLONI] J7QVL JTAVTIVAY 202008/2E Saucy JTaVL FTV TIVAY 
asoa/s HONS? IST) 3HYN a92008/BE SSFWddY 1ST IMWN 
woza/2e NOVUL/SYOLIIS 40 UIQHNN a20a/2 WAONTTAI/SNIVUL 40 W3EHNN 
atoa/T = (SY0L93S) NOTLYIOTIV 40 LINN =a S00a/88 “SUIENTTAD 40 W3BHNN 
900000 LNG] YOUN WALI 000000 — LNNOD ¥O193S ava 
0 OWT ALTUOSINI ON JOMIWLWD C3LITSTY 
309 §8390¥ . 003 Vd 
Sag WIISAS NOTLYZIWILINE OSTA FAVE NOLLVZEWILINT 
oll NOTLVOTATINIGI SU3NAO 
600000 W3GHNN “W1U3S USTIAW MILITANT 3OMTNLUYD E 
a 
¥ 
“SNOD YL, 


C1O°TO°E] NOISUIA Va rod + 
MSIQW WI E 
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; 
Q3IVI0TIW 10N= 00 91-2 
910008/4 a7c00a/4s 935008/96 QU3H d3LvIOTIY = 0 1 1 
vaUY NI ssauday 21 
SqyO7aY 40 3aWNN =©—s«-AZIS vaUy LWVLS Yau avu ita ¥aW 
f-S S118 (0) - SUaSN $$390¥ 4907 
> 1a ) - Syasn indie 
2-0 S118 (0) —-- SU3SN WLOL =SiNNOD wasn 
300008/0 -« @NOTIY LS¥T NI S3LAa 3uvdS 970008/9 yauy 1S¥T NI 93Y 
Ackeedé qI-N¥d M014N3N0 atoa/T 35n NI S¥RY XH 
(6éa) ss WOLIVA BANS a92008/9S 31S FUW4 XW 
a1000a/1 9018/S¥0.1935 a10008/T 95078 /S0Y0234 
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APPENDIX C 
GLOSSARY OF TECHNICAL TERMS 


ADDRESS 


A disk is divided physically into tracks and sectors, both numbered sequentially from zero upwards. These 
‘numbers‘ are referred to as ‘addresses’. The MCP uses this address scheme to quickly locate data on disk. 


ALPHANUMERIC 


Consisting only of letters of the alphabet plus the ten numeric digits; that is, not containing any other special 
characters. 


APPLICATION PROGRAM 


User program that performs day-to-day functions such as invoicing, printing, inventory reports, etc. 


ATTRIBUTE 
Characteristic or quality. 


BACK-UP 


4 


Term used to describe the method of insuring that copies of files exist to standby as alternatives. 


BINARY-CODED DECIMAL (BCD) 


A method of coding numeric information in 4-bit units representing 0 as bits 0000, 1 as bits 0001, 2 as bits 
0010, up to 9 as bits 1001. For example, the number 1607 in BCD would take four 4-bit units (2 bytes), coded 
as 0001 0110 0000 0111. 


BOJ 


‘Beginning of Job‘ The term used to notify the operator that a program has entered the ‘mix‘ and has just 
started running. 


BSMD 

Abbreviation for ‘Buiroughs Super Mini Disk‘. 
BYTE 

One alphanumeric character of data. 


CHECKERBOARDED 


Term applied to any disk having available spaces of varying sizes scattered about the disk amongst files. The 
term can also be applied to memory in a virtual memory system where ‘locked‘ or ‘save‘ areas are scattered 
through the memory in such a way as to impede getting overlayable memory areas of sufficient size for optimum 
throughput. 
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CMS 


Computer Management System. A set of interrelated specifications for system software, including high-level 
language compilers, object-code formats, operator interface and data communications, which Burroughs has im- 
plemented on machines of different hardware characteristics. 7 


COMPILATION DATE 


The date on which a programmer’s source code was compiled : that is, the creation date of the executable 
object program. 


COMPILERS 


Group of system programs that convert instructions written by a programmer in a language such as COBOL 
or RPG into a form which can be run or interpreted by the hardware or system software. 


CONFIGURATION 


Term used to describe the arrangement of various hardware devices in a particular system. 


DATA FILE 
A set of information usually or a disk, which is used as data to be input. 
DEFAULT VALUE 
Usually a meaning that a program will assume if not instructed étherwise. 
DESTINATION 
Disk to which information is being transferred. 
DISK DIRECTORY BoD 
List, on Track 0, of file names, locations on disk, and sizes. Similar to a table of contents. 


DISK FILE 


Set of information residing on a disk medium, collectively referred to by its name, ‘file-name‘ and the name 
of the disk on which it resides (‘disk-name‘). 


DISK NAME 


Name by which a disk is known to MCP. Every disk medium has a ‘label‘ of information written to it during 
disk initialization, and the disk name is part of the ‘label’. | 


DUAL-PACK FILE (MULTI-VOLUME FILE) 


A file that resides on two separate disks or logically defined disks (for example, DKA, DKB). 


EOJ 


‘End of Job‘. The term used to notify the operator that a program has terminated. ‘Abnormal‘ end-of-job 
occurs when a program is terminated prematurely due to an error condition. : : 
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EXECUTION 


The running of a program is termed ‘program execution‘. The operator can execute (or start) a program by 
entering the name of the program desired (or disk-name/program if program resides on user disk). When a pro- 
gram is ‘executed‘, it enters the ‘mix‘ and is assigned a ‘mix number‘ by the MCP. 


FAMILY (GROUP) OF FILES 


Two or more disk files having at least the first letter of their names in common. For example, ‘PR020°, 
‘PRFILE‘, and ‘PASMI* are members of a family of files that could be referred to as ‘P—. 


HARDWARE 


Term referring to all equipment on the system. Line printers and disk cabinets are examples. 


HEXADECIMAL (‘HEX’) 


A number system based on root 16, in contrast to common ‘decimal’ system based on root 10. To provide 
additional symbols, the letters A through F are used, so that counting procedes thus: 0, 1, 2, 3, 5, 6, 7, 8, 
9, A, B, C, D, E, F, 10, 11, 12 ... for decimal numbers 0 through 18 ... 


INTERPRETER 


A system software item used as an intermediate step in the running of a program. Instead of using a compiler 
to transform programs directly to machine instructions which can be run by the processor, a compiler may trans- 
form the program to an intermediate form (called ‘S-code‘). The S-code can be ‘interpreted‘ by the interpreter, 
that is, translated into machine instructions that can be run by the processor. 


INTRINSIC 


A ‘command‘ used by the operator to direct the activities of the MCP. Intrinsics are actually a part of the 
MCP and therefore will never be seen on a disk file listing or in the ‘mix‘. Examples of intrinsics include ‘DS‘ 
(discontinue the processing of a program) and ‘DT“ (retrieve or change system date). 


KEYFILE 
File used by system as an index to a master data file. 


LABEL 


A small space of disk on tape indicating the medium’s contents, name, etc. A disk label may be created during 
the initialization process, and a tape label is created when the tape is purged. 


MAIN MEMORY 
Circuit boards inside processor where program code and data in immediate use are held. 


MCP (“Master Control Program”) 


Program which is the central part of the CMS software system. It handles hardware devices, communicates 
with the operator, and controls processing of programs. 


MIX 


Term applied to the mixture of programs running in a multi-programming environment. A ‘mix-number'‘ its 
a number which is assigned by the MCP to a program when it enters the ‘mix’. A ‘null mix is when no jobs 
are running. | 

The program’s name and mix number can be used by the operator to refer to a particular program in the 
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MULTIPROGRAMMING 


One processor working on more than one program at a time. Processing can be shared on a ‘round-robbin‘ 
basis, and computation can be overlapped with input/output if there is more than one program ‘in the mix‘. 


ON-LINE 
Term used for equipment or media currently used as part of the system. 
PACK. 
Synonym for ‘disk‘ 
PERIPHERAL 
Hardware device used as input or output. Examples are line printer, disk drive unit, console keyboard. 
PURGE 
To erase when disks or tapes are ‘purged‘, their contents are lost. 


SECTOR 


A disk is divided physically into data storage spaces called sectors, numbered sequentially from zero upwards. 
Fach sector is 180 characters in length. | 


SOFTWARE 

Term referring to programs and files, as distinct from the ‘hardware‘ of the actual machine. 
SOURCE DISK 

Disk from which information is being transferred. 


SOURCE FILE 


A disk file containing statements (instructions) written by a programmer in a high-level language such as 
COBOL or RPG, before it has been transformed into a runnable program. 


STAND-ALONE PROGRAMS 


Programs that do not run under control of the MCP. In particular, functions of general use to all B80 users 
are held in a disk file called ‘SAU‘(Stand Alone Utilities). Examples include LS (list disk name and sizes), and 
RL (relabel a disk). Loading and execution of SAU is done with no need of the MCP. Refer to Section 8 for 
details. : | 


STARFILE 


A small disk file optionally used at the start of most CMS-common utilities. The information in the starfile 
is used to build up the initiating message for the utility, which could also be entered by the operator on the 
SPO. Starfiles are also called ‘macro-files‘. | 


SYSTEM DISK 


The disk containing the copy of the MCP that is currently in use. 


Note that a user disk may also contain MCP code files, but only the disk containing the MCP that is in use 
since the last warmstart is the system disk. There can be only one system disk at any time during operation. 
System disks cannot be used as system disks on more than one CMS product (see section 2 for details). 


c-4 


SYSTEM FILE 


A disk file which is used by the system software. Special control is placed on these files to minimise the 
danger of accidental removal from the disk (see RM utility). 


SYSTEM SOFTWARE UTILITY 


A program of general use to all users, as opposed to an application program which performs a particular using 
day-to-day tasks, such as invoicing. Examples of utilities include COPY (copy files from one medium to another) 
and RM (remove files from a disk). 


USER DISK 
Any disk available to the system that is not a system disk. 


VIRTUAL MEMORY 


A software technique, implemented in the MCP, of allowing programs to execute (or several to execute to- 
gether) when the total program memory requirements exceeds the amount of memory physically available. Some 
of the executing program’s code and data, which is not in immediate use, is stored on disk media and not in 
main memory. When the code, or data, is required, space is made for it in main memory and the information 
read back from disk. To make space in memory, it may be necessary for the MCP to re-use some memory 
which has previously been used by the program and is not required at this moment. Before re-using memory 
containing data that could have been updated, the MCP writes this segment of memory to the program’s ‘virtual 
memory file‘ on disk. 


This technique also applies to the code and data of the MCP and other system sofware. 
VOLUME 
Synonym for ‘disk*. 


WRITE INHIBIT 


To prevent disk on tape media from being written to by a program. The manner in which this is accomplished 
depends upon the medium (see B80 or B800 System Operator manuals for details). 


WRITE PERMIT 


To allow any disk or tape medium to be written to by a program. The manner in which this is accomplished 
depends upon the medium (see B 80 or B 800 System Operator manuals for details). 
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APPENDIX D 
RELATED DOCUMENTATION 


The following manuals provide information concerning CMS System Software: 


Manual Form Number 
CMS ARCS Reference Manual 2012713 
CMS COBOL Reference Manual 2007266 
CMS MCP Reference Manual 2007266 
CMS RPG Reference Manual 2007274 
CMS MPLII Reference Manual 2007563 
CMS NDL Reference Manual 


1090925 
CMS Data Communications Subsystem Reference Manual 1090909 
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